[Ducksss]

Summary

One colour and symbol per profile, shown everywhere: the menu-bar app, the shell prompt, Raycast and new launchers. Stacked on #96, which added colours to the menu-bar app; GitHub retargets this to main once #96 merges.

• New codex-profile appearance command.

  codex-profile appearance                                   # every profile
  codex-profile appearance work --color teal --symbol briefcase
  codex-profile appearance work --reset
  codex-profile appearance --json

  • Without a choice, default is graphite and other profiles take a stable colour from an FNV-1a hash of their name, computed the same way as the app.
  • The palette leaves out red, orange and yellow, which mean low quota.
  • Choices live in a private appearance.tsv next to the workspace registry, written atomically under the state lock with symlinks refused. Damaged lines fall back to automatic, and remove forgets the profile's entry.
  • usage(), per-command help, USAGE.md, llms.txt and the bash, zsh and fish completions all cover the new command.
• Menu-bar app. It reads appearances on each refresh and saves choices through the CLI instead of its own preferences.
  • A choice shows at once, and writes run in order, so quick clicks can't land out of order.
  • A refresh never overwrites a write that's still in flight.
  • A refused write shows the CLI's reason and reloads what the CLI holds.
• Shell prompt. env exports CODEX_PROFILE_COLOR, and shell-init --prompt puts a ● in the profile's colour before [codex:<profile>] in bash, zsh and fish. The dot uses fixed escapes, so earlier dots are removed exactly and never stack, including through venv-style prompt restores. NO_COLOR leaves it out, and the prompt never runs the CLI.
• Raycast. Open Profile tints each profile's icon with its colour. An older codex-profile without appearance keeps plain icons.
• Launchers. launcher create uses the profile's colour unless --color is given. Launcher colours gain indigo and brown, and red and orange are still accepted.

Not in this PR: symbols in Raycast, since its built-in icons don't map cleanly to the twelve symbols. Colour-coded Terminal tabs are also left out; CODEX_PROFILE_TERMINAL_TITLE already labels titles.

Testing

• make check passes, including ShellCheck.
• New test/cli/appearance-test.sh covers:
  • automatic colours, and that reading never creates the registry;
  • set, partial update and reset, with private file modes;
  • refused colours, symbols, profiles and flag combinations;
  • damaged lines and a symlinked registry;
  • env in POSIX and fish;
  • remove.
• launcher-test.sh covers the default colour following the profile, and an explicit --color still winning.
• prompt-test.sh runs the existing transcripts with NO_COLOR and adds dot checks in bash, zsh and fish: colour, no stacking, switching profile.
• completions-test.sh covers the new flags and values in all three shells.
• The native real-CLI test checks that Bash and Swift pick the same automatic colour, and round-trips a choice, a reset and a refused write.
• Raycast npm test passes (58 tests). It includes checks that Raycast's colours match the CLI's names and the app's exact values.
• Not run: Raycast's npm run typecheck, npx eslint and npx prettier --check, which need npm ci in raycast/. The new code reuses the existing { source, tintColor } image shape and Object.hasOwn (ES2022).

Scope and compatibility

• Affected scope: the CLI's new appearance command, env output, the opt-in prompt and launcher defaults, plus the menu-bar app and Raycast. cli/login behaviour, app default and named Desktop launches are unchanged.
• Compatibility impact:
  • env now prints a third line, CODEX_PROFILE_COLOR.
  • launcher create without --color now uses the profile colour instead of always blue.
  • The prompt shows a coloured dot unless NO_COLOR is set.
  • The state schema version is unchanged; appearance.tsv is an optional, additive file.
  • Choices saved by an unreleased frontend(feat): give profiles colours and show quota in the menu bar #96 build in UserDefaults aren't migrated.

Checklist

• I ran make check; if the environment lacks ShellCheck, I ran
  make test and documented the missing lint result instead.
• I did not add code that reads, copies, prints, parses, uploads, compares,
  or migrates auth tokens or ChatGPT cookies.
• Desktop changes preserve the stock app default session and use the
  original signed app bundle.
• I did not claim that CLI and Desktop account equality can be inspected or verified.
• I updated documentation for user-facing behavior changes.

🤖 Generated with Claude Code

[coderabbitai]

Caution

Review failed

The pull request is closed.

Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.