OrcaORCA
Star us4.9k

Settings reference

Settings are grouped into panes. Everything here is searchable with Cmd-, then typing a keyword. Feature pages in these docs link directly to the relevant pane.

General

  • Updates — check for and install updates. Shift-click Check for Updates to include RC builds.
  • UI zoom — per-install UI scale.
  • Default new-worktree name — custom prefix or marine creatures.

Appearance

  • Theme, accent color, density.
  • Font family for UI and editor (independent settings — pick any installed font for either).
  • Editor minimap toggle.
  • Status bar toggles.
  • App Icon — cycle between Classic, Watercolor, and Blue for the icon shown in the Dock and window switcher.

Git

  • Default base ref resolver.
  • Commit signing options.
  • Editor for external git tools.
  • Auto-Rename Branch From Work — rename Orca-generated creature branches after an agent starts work.

Terminal

  • Font, theme, cursor style, padding.
  • Ghostty import.
  • Warp theme import — bring in your Warp YAML themes with Import themes from Warp (auto-discovers Warp's themes folder per OS) or Import from YAML for any folder of Warp-format theme files.
  • JIS Yen (¥) to Backslash (\) for macOS Japanese keyboards.
  • Windows default shell (PowerShell or CMD).

Quick Commands

  • Saved terminal commands, scoped globally or to a project.
  • Scope filters for reviewing and editing the command list.

Agents

  • Installed agents — detected and custom.
  • Enable or disable detected agents so launch menus only show the CLIs you want to use.
  • Claude and Codex account lists.
  • Startup hooks per agent.

Browser

  • Profiles (see Browser-use profiles).
  • Default Zoom — zoom level applied to newly opened browser tabs (per-tab adjustments via Cmd-wheel are remembered separately).
  • Design Mode defaults.
  • Devtools opt-in.

Integrations

  • GitHub OAuth.
  • Linear API token.
  • Jira — Atlassian site URL, email, and API token (see Jira items drawer).
  • MCP servers.

Notifications

  • Agent-finished: system, sound, chip.
  • Custom desktop notification sound per category.
  • PR check failures.
  • Update available.

Voice

  • Cloud speech-to-text models — paste an OpenAI API key under OpenAI Transcription to enable cloud STT for dictation. The key is stored locally and only used to call OpenAI's transcription API.

SSH

  • Targets, passphrases, default identity file.

Shortcuts

  • Full keymap — every binding remappable.

Repository

  • Per-repo base ref and hooks.
  • Auto-run commands on worktree create.
  • Repo icons for the sidebar: choose an icon, emoji, uploaded image, website favicon, or GitHub avatar, then pick a preset or custom hex badge color.
  • Source Control AI overrides for commit messages, pull request details, and branch names.

Experimental

  • Orca CLI registration.
  • Activity Page — Slack-style worktree feed for agent events.
  • Compact worktree cards — hide redundant second lines in the sidebar while the layout is still experimental.
  • Features not yet stable — behavior may change.