Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import type { TelemetrySettings } from './telemetry-settings-types'
import type { BrowserProfileScope } from './browser-profile-scope'
import type { GlobalSettingsBase } from './global-settings-base'
import type { ExecutionHostId } from './execution-host'
import type { OrcaWorkspaceLayout } from './orca-workspace-layout'
import type { GitHubProjectSettings } from './github/project-types'
import type { VoiceSettings } from './speech-types'
import type { AiVaultSearchSettings } from './ai-vault-search-settings'
import type { GitLabProjectSettings } from './gitlab-types'
import type { TaskProvider } from './task-providers'
import type { KeybindingOverrides, TerminalShortcutPolicy } from './keybindings'
import type { AppIconId } from './app-icon'
import type { SourceControlAiSettings } from './source-control-ai-types'
import type { ClaudeAgentTeamsMode } from './claude-agent-teams-tmux-compat'
import type { TerminalCustomTheme } from './terminal-custom-themes'
import type { UiLanguage } from './ui-language'
import type { GlobalWindowsRuntimeDefault } from './project-execution-runtime'
import type { PersistedNativeChatSessionOptions } from './native-chat/input/native-chat-session-options'
import type { AgentChatPermissionMode } from './agent-chat-permission-mode'
import type { ComputerAwakeMode } from './computer-awake-mode'
import type { CommitMessageAiSettings } from './commit-message-ai-types'
import type { HostSettingOverrides } from './host-setting-overrides'
import type {
ClaudeManagedAccount,
ClaudeManagedAccountRuntimeSelection,
CodexManagedAccount,
CodexManagedAccountRuntimeSelection
} from './managed-account-types'
import type { NotificationSettings } from './notification-settings-types'
import type { CtrlTabOrderMode } from './tab-types'
import type { TerminalColorOverrides } from './terminal-color-overrides'
import type { TerminalQuickCommand } from './terminal-quick-command-types'
import type { TuiAgent } from './tui-agent'
import type { ZcodePlanSite } from './zcode-plan-sites'
import type {
AgentDashboardMode,
BranchPrefixStrategy,
FloatingTerminalTriggerLocation,
JiraIssueKeyCasing,
LeftSidebarAppearanceMode,
OpenInApplication,
SourceControlGroupOrder,
SourceControlViewMode,
TaskViewPresetId
} from './ui-chrome-types'
import type { WorktreeVisibilityDefaults } from './repo-types'
export type { WorktreeVisibilityDefaults } from './repo-types'
/** MiniMax account region used to select the quota endpoint. */
export type MiniMaxEndpoint = 'overseas' | 'cn'
export type GlobalSettings = GlobalSettingsBase & {
workspaceDir: string
/** Host-owned defaults used when a repository has no explicit visibility override. */
worktreeVisibilityDefaults?: WorktreeVisibilityDefaults
/** Per-host value is host override ?? client default, keyed by ExecutionHostId. */
hostSettingOverrides?: Partial<Record<ExecutionHostId, HostSettingOverrides>>
nestWorkspaces: boolean
workspaceDirHistory?: OrcaWorkspaceLayout[]
refreshLocalBaseRefOnWorktreeCreate: boolean
/** Permanently dismisses the suggestion to enable local base refresh. */
localBaseRefSuggestionDismissed: boolean
/** Rename generated creature branches from first-prompt work; users can disable this in global Git settings. */
autoRenameBranchFromWork: boolean
/** One-shot migration guard for the default-on rollout. Existing profiles
* without the guard are flipped on once; later explicit opt-outs stick. */
autoRenameBranchFromWorkDefaultedOn?: boolean
branchPrefix: BranchPrefixStrategy
branchPrefixCustom: string
/** Jira key casing for newly generated Jira-linked workspace and branch names.
* Existing workspaces and user-typed names are never rewritten. */
jiraIssueKeyCasing?: JiraIssueKeyCasing
theme: 'system' | 'dark' | 'light'
/** Controls the left sidebar surface without changing terminal brightness. */
leftSidebarAppearanceMode: LeftSidebarAppearanceMode
leftSidebarTintColor?: string
leftSidebarTintOpacity?: number
uiLanguage: UiLanguage
uiLanguagePortugueseMigrationApplied?: boolean
appIcon: AppIconId
appFontFamily: string
editorAutoSave: boolean
editorAutoSaveDelayMs: number
editorMinimapEnabled: boolean
/** Opt-in code-editor font; empty (the default) keeps following `terminalFontFamily`. */
editorFontFamily?: string
/** Defaults on for profiles saved before file-editor wrapping became configurable. */
editorWordWrap?: boolean
/** Persisted opt-out for browser spellcheck noise in rich Markdown editing surfaces. */
richMarkdownSpellcheckEnabled?: boolean
/** Whether local markdown review note controls and the review panel are shown. */
markdownReviewToolsEnabled: boolean
/** Selection paste preserves the normal clipboard; defaults on for Linux/macOS, off for Windows. */
primarySelectionMiddleClickPaste?: boolean
/** One-shot migration guard for turning the Linux default on for profiles
* that persisted the earlier off-by-default value. */
primarySelectionMiddleClickPasteDefaultedForLinux?: boolean
/** One-shot migration guard for widening the terminal-style default to
* Linux/macOS while preserving later explicit opt-outs. */
primarySelectionMiddleClickPasteDefaultedForTerminalDefaults?: boolean
terminalFontSize: number
terminalFontFamily: string
terminalFontWeight: number
terminalFontWeightBold: number
terminalLineHeight: number
terminalScrollSensitivity: number
terminalFastScrollSensitivity: number
terminalTuiScrollSensitivity: number
/** One-shot migration guard for moving inherited TUI wheel reports from 3 to 1. */
terminalTuiScrollSensitivityDefaultedToOne?: boolean
/** auto tries WebGL with DOM fallback for risk/unsupported hosts; on always tries WebGL; off uses DOM. */
terminalGpuAcceleration: 'auto' | 'on' | 'off'
/** auto enables @xterm/addon-ligatures only for known ligature fonts (Fira Code, JetBrains Mono, Cascadia).
* Explicit on/off survives font changes. */
terminalLigatures: 'auto' | 'on' | 'off'
/** Enable SIXEL/iTerm2/Kitty via lazy @xterm/addon-image; image canvas/storage allocates only after a pane receives an image. */
terminalInlineImages: boolean
terminalCursorStyle: 'bar' | 'block' | 'underline'
/** One-shot migration guard for moving inherited cursor defaults to block. */
terminalCursorStyleDefaultedToBlock?: boolean
terminalCursorBlink: boolean
terminalThemeDark: string
terminalCustomThemes?: TerminalCustomTheme[]
terminalDividerColorDark: string
terminalUseSeparateLightTheme: boolean
terminalThemeLight: string
terminalDividerColorLight: string
terminalInactivePaneOpacity: number
terminalActivePaneOpacity: number
terminalPaneOpacityTransitionMs: number
terminalDividerThicknessPx: number
terminalBackgroundOpacity?: number
/** xterm minimumContrastRatio floor for terminal panes (#10754). Undefined keeps the automatic,
* background-luminance-gated floor (3 dark / 4.5 light); 1 disables contrast correction so TUIs
* that rely on deliberately low contrast (Powerline seams, dimmed secondary text) render as sent. */
terminalMinimumContrastRatio?: number
terminalColorOverrides?: TerminalColorOverrides
terminalPaddingX?: number
terminalPaddingY?: number
terminalMouseHideWhileTyping?: boolean
terminalWordSeparator?: string
terminalCursorOpacity?: number
terminalQuickCommands?: TerminalQuickCommand[]
windowBackgroundBlur?: boolean
/** Windows-only: close (X) hides to tray instead of quitting; the tray icon is always present regardless. */
minimizeToTrayOnClose?: boolean
/** macOS: toggles the additive menu-bar entry (Orca survives last-window close); doesn't change Dock behavior. */
showMenuBarIcon?: boolean
/** Windows convention: right-click pastes; macOS/Linux keep the context menu. */
terminalRightClickToPaste: boolean
/** One-shot guard distinguishing the old global true default from a per-platform choice. */
terminalRightClickToPasteDefaultedForPlatform?: boolean
/** Windows-only: COMSPEC always points to cmd.exe, so this explicit shell (default 'powershell.exe') overrides it. */
terminalWindowsShell: string
/** Optional shell executable for new terminals on macOS and Linux. */
terminalDefaultShell?: string
/** Optional argv passed to the configured Unix shell for ordinary interactive panes. */
terminalDefaultShellArgs?: string[]
/** Pins the WSL distro for terminals/agent scans instead of WSL's current global default. */
terminalWindowsWslDistro?: string | null
/** Account/auth location; auto follows the global Windows runtime while host/wsl pin it. */
localAccountRuntime: 'auto' | 'host' | 'wsl'
localAccountWslDistro?: string | null
/** One-shot guard for migrating the legacy host default to auto. */
localAccountRuntimeDefaultedToAutoForAllUsers?: boolean
/** Independent from the terminal shell so users can inspect Windows vs WSL agent PATH state without changing it. */
localAgentRuntime?: 'host' | 'wsl'
localAgentWslDistro?: string | null
/** Why: global is only the default policy; project-level runtime preference wins. */
localWindowsRuntimeDefault: GlobalWindowsRuntimeDefault
/** 'auto' resolves to PowerShell 7+ when present, else falls back to inbox Windows PowerShell. */
terminalWindowsPowerShellImplementation: 'auto' | 'powershell.exe' | 'pwsh.exe'
terminalFocusFollowsMouse: boolean
/** X11/gnome-terminal "copy on select": selecting text auto-copies to the clipboard; default off. */
terminalClipboardOnSelect: boolean
/** Drops the left gutter agent CLIs paint their output behind when copying a terminal selection; default on. */
terminalCopyTrimsGutter: boolean
/** Enables OSC 52 clipboard writes for TUIs (tmux/Zellij/nvim, incl. over SSH); default on. Clipboard *queries* stay blocked and payload size is capped, so this is write-only exposure. */
terminalAllowOsc52Clipboard: boolean
/** One-shot stamp: profiles saved under the old off default get flipped on once, after which an explicit opt-out sticks. */
terminalAllowOsc52ClipboardDefaultedOnForAllUsers?: boolean
/** Experimental Claude Agent Teams; native panes use a tmux-compatible shim so teammate output stays on the normal PTY path. */
claudeAgentTeamsMode?: ClaudeAgentTeamsMode
terminalScrollbackRows: number
/** Optional app-level proxy for Electron networking and local PTYs; empty preserves system/inherited proxy env. */
httpProxyUrl?: string
/** Optional semicolon/comma/newline-separated bypass rules for httpProxyUrl. */
httpProxyBypassRules?: string
/** Optional mirror of nodejs.org/dist for the Node runtime Orca installs on SSH and WSL servers. */
nodeDistMirrorUrl?: string
/** Why: corporate TLS-intercepting proxies can break HTTP/2 downloads; opt-in Chromium process-wide HTTP/1.1 switch. */
electronHttp1CompatibilityMode?: boolean
/** Opt-in in-app browsing (isolated guest surface); default keeps links opening in the system browser. */
openLinksInApp: boolean
/** Worktree-scoped localhost hostnames to distinguish tabs; opt-in since a non-localhost host can break apps binding cookies/sessions to localhost. */
localhostWorktreeLabelsEnabled?: boolean
/** Tracks the one-time first-use prompt for terminal link routing (avoid silently changing where links open). */
openLinksInAppPreferencePrompted: boolean
/** Opt-in: Shift+modifier click inverts openLinksInApp instead of always forcing the system browser. Off keeps the historical one-way escape hatch. */
openLinksInAppModifierInverts?: boolean
/** Show link actions on plain click in the terminal and chat; off restores modifier-click-only terminal links. */
terminalLinkActionPopoverEnabled?: boolean
/** Plain-click behavior for terminal links; optional for profiles saved before this setting existed. */
terminalLinkClickBehavior?: 'actions' | 'open' | 'none'
/** Middle mouse URL behavior; defaults to opening the primary routed destination. */
terminalUrlMiddleClickBehavior?: 'open' | 'actions' | 'none'
/** New supported agent launches use structured Chat UI; off defaults to terminal UI. */
experimentalNativeChat?: boolean
/** Opt-in resume of working structured chats after restart; off still lists them for review before token spending. */
nativeChatResumeWorkOnRestart?: boolean
/** Queue editable mid-turn follow-ups until turn end on capable hosts. Absent means on; off sends immediately. */
nativeChatQueueFollowUps?: boolean
/** Teach newly started native chats to create inline visuals; absent means on. */
nativeChatInlineVisuals?: boolean
/** Hovering a web link in chat fetches the page to preview it; absent means on. GitHub cards ignore this. */
nativeChatLinkPreviews?: boolean
/** Structured Codex/Claude chats inherit the login-shell env; off limits it to nativeChatShellEnvironmentVariables plus PATH/locale. */
nativeChatInheritShellEnvironment?: boolean
/** Login-shell variable names structured chat inherits while the whole environment is off. */
nativeChatShellEnvironmentVariables?: string[]
/** Last explicit native-chat model + option selections; live panes need an applied/dispatched record before showing a value. */
nativeChatSessionOptions?: PersistedNativeChatSessionOptions
/** Legacy client permission control and host-support marker; kept valid for old peers. */
nativeChatPermissionMode?: AgentChatPermissionMode
/** Extra launcher rows for the worktree "Open in" submenu. VS Code is always shown first. */
openInApplications?: OpenInApplication[]
/** Deprecated: migration/backward-compat only. Use PersistedUIState.rightSidebarOpen. */
rightSidebarOpenByDefault: boolean
followSymlinkedDirectories?: boolean
showGitIgnoredFiles?: boolean
/** Preferred Source Control changes layout. Per-user, not per-workspace. */
sourceControlViewMode: SourceControlViewMode
/** Preferred Source Control group order. Per-user, not per-workspace. */
sourceControlGroupOrder: SourceControlGroupOrder
/** Compare base defaults to the branch upstream instead of the repo default; affects only the compare/diff view, not the PR/rebase target. Per-user. */
sourceControlCompareAgainstUpstream: boolean
/** Whether to show the Orca app name in the titlebar. */
showTitlebarAppName: boolean
/** Hides the Tasks sidebar button (also removes it from keyboard navigation). */
showTasksButton: boolean
/** Only toggles the sidebar shortcut; Automations stay reachable from Settings/View menu. */
showAutomationsButton?: boolean
/** Deprecated: Artifacts are always available. Use showArtifactsButton for sidebar visibility. */
artifactsEnabled?: boolean
/** Capability gate for agent-driven publishing; off until granted, enforced in main, not just the UI. */
artifactSharingEnabled?: boolean
/** Capability gate for agent/CLI skill publishing; manual reviewed publishing remains available. */
agentSkillSharingEnabled?: boolean
/** Maximum worker nesting; 1 forbids sub-workers. Renderer-only: omit from SettingsUpdate RPC so workers cannot raise their cap. */
nestedWorkerMaxDepth?: number
/** Escalate native-chat worker turn errors to the dispatching Run; absent means on. Renderer-only so workers cannot silence failures via CLI. */
orchestrationChatErrorEscalationEnabled?: boolean
/** Only toggles the sidebar shortcut; Artifacts stay reachable from Settings. */
showArtifactsButton?: boolean
/** Only toggles the sidebar shortcut; Skills stay reachable from Settings. */
showSkillsButton?: boolean
/** Only toggles the sidebar shortcut; Orca Mobile stays reachable from Settings. */
showMobileButton?: boolean
/** Pinned workspaces show in one sidebar location by default; opt in to also show them in their natural groups. */
showPinnedWorktreesInGroups?: boolean
/** How Ctrl+Tab picks the next visible tab; optional (older profiles), readers default to MRU. */
ctrlTabOrderMode?: CtrlTabOrderMode
/** Orca-first keeps app shortcuts from TUIs; terminal-first is opt-in to let shell/TUI bindings win. */
terminalShortcutPolicy?: TerminalShortcutPolicy
/** Floating Workspace: global surface for terminal/browser/markdown tabs outside repo/worktree context. */
floatingTerminalEnabled: boolean
/** Main-side new-page kill switch for paired Electron client-hosted browser placement. */
browserClientHostedRemoteEnabled?: boolean
/** Browser profile new tabs in a workspace use; missing = 'shared' (the Default profile). */
browserProfileScope?: BrowserProfileScope
/** Profile new tabs use per browser host when no repo/workspace profile applies; missing = Default. */
browserDefaultProfileIdByHostId?: Partial<Record<ExecutionHostId, string>>
/** Routes SSH-workspace browser pages through the workspace's SSH host; off = plain local browsing. */
browserSshWorkspaceRoutingEnabled?: boolean
/** Per-target opt-outs recorded from the routing error card's "Browse from this device instead". */
browserSshWorkspaceRoutingDisabledTargetIds?: string[]
/** Targets whose forwarding preflight the user overrode via "Try anyway" (e.g. PermitOpen allows their sites); skips the probe, never changes egress. */
browserSshWorkspaceRoutingProbeSkippedTargetIds?: string[]
/** One-shot migration flag for the floating-workspace default-on rollout; after migration an explicit off sticks. */
floatingTerminalDefaultedForAllUsers?: boolean
/** Start dir for new floating-workspace terminal tabs; empty or '~' = home dir. */
floatingTerminalCwd: string
/** Picker-approved floating-workspace dirs reauthorized across restarts; renderer text alone must not populate this. */
floatingTerminalTrustedCwds?: string[]
/** One-shot migration marker for legacy floating workspace cwd trust grants. */
floatingTerminalCwdMigratedToAppWorkspace?: boolean
/** Where the Floating Workspace toggle is shown; defaults to the floating button for discoverability. */
floatingTerminalTriggerLocation: FloatingTerminalTriggerLocation
/** Legacy keyboard-shortcut overrides; new writes go to ~/.orca/keybindings.json, migrated once when present. */
keybindings?: KeybindingOverrides
diffDefaultView: 'inline' | 'side-by-side'
diffWordWrap: boolean
diffShowWhitespace: boolean
/** Opt-in: single-file diffs collapse unchanged regions, as the combined diff view already does; optional for legacy settings. */
diffCollapseUnchangedRegions?: boolean
combinedDiffFileTreeVisibleByDefault: boolean
/** Bot-marked comment-author logins (stored lowercased); escape hatch for review bots on regular accounts that defeat provider metadata/heuristics. */
prBotAuthorOverrides: string[]
notifications: NotificationSettings
/** Countdown after a Claude agent goes idle showing time left before the prompt cache expires. */
promptCacheTimerEnabled: boolean
/** Prompt-cache TTL (ms); only 300000 (5 min standard) or 3600000 (1 hr, extended-TTL plans). */
promptCacheTtlMs: number
/** Why: durable main-owned pref so Orca can prepare shared ~/.codex before the renderer hydrates. */
codexManagedAccounts: CodexManagedAccount[]
activeCodexManagedAccountId: string | null
activeCodexManagedAccountIdsByRuntime?: CodexManagedAccountRuntimeSelection
/** Why: persist only per-account auth (not a CLAUDE_CONFIG_DIR swap) so switching accounts doesn't fork Claude's shared chat/session context. */
claudeManagedAccounts: ClaudeManagedAccount[]
activeClaudeManagedAccountId: string | null
activeClaudeManagedAccountIdsByRuntime?: ClaudeManagedAccountRuntimeSelection
/** Dismissed the "System default may hold a copied login" notice in Settings > Accounts. */
claudeCopiedSystemDefaultNoticeDismissed?: boolean
/** Scope bash/zsh HISTFILE and fish_history by worktree so ArrowUp does not expose other worktrees’ commands; default true. */
terminalScopeHistoryByWorktree: boolean
/** Kill switch for hidden terminal view parking: unmount long-hidden panes while a pane-less watcher keeps PTY side effects alive. */
terminalHiddenViewParking?: boolean
/** Kill switch for SSH terminal parking (C1): SSH panes park like local ones; reveal restores from main's headless model, falling back to relay replay. */
terminalSshViewParking?: boolean
/** Kill switch for the hidden-worktree retention budget (C1): force-parks the least-recently-hidden un-parkable worktrees beyond a count budget or TTL. */
terminalHiddenWorktreeRetentionBudget?: boolean
/** Kill switch for the browser-guest worktree retention budget: destroys the least-recently-activated hidden worktrees' webview guests beyond an LRU count budget. */
browserGuestWorktreeRetentionBudget?: boolean
/** Kill switch for main-process PTY side-effect authority; on (default) = title/bell/agent facts via pty:sideEffect channel, not renderer byte parsing. */
terminalMainSideEffectAuthority?: boolean
/** Kill switch for main's hidden-delivery gate (Phase 4): drops PTY bytes to hidden views after model ingestion; requires terminalMainSideEffectAuthority. */
terminalHiddenDeliveryGate?: boolean
/** Kill switch for main's model query responder (Phase 5); active only when both Phase-4 gates are also on. */
terminalModelQueryAuthority?: boolean
/** New-workspace agent: null chooses first detected, blank launches no agent, otherwise select that TuiAgent. */
defaultTuiAgent: TuiAgent | 'blank' | null
/** @deprecated Retained for older peers; setup-only is now a per-create choice. */
newWorkspaceSetupOnly?: boolean
/** Agents hidden from picker/auto-launch; detection stays a raw PATH snapshot. */
disabledTuiAgents: TuiAgent[]
/** One-shot guard: start Claude Agent Teams hidden for existing profiles without overriding later opt-ins. */
claudeAgentTeamsDefaultDisabledMigrated?: boolean
/** One-shot guard: hosts saved before the remote CLI control default flip were pinned off. */
sshRemoteCliControlExistingHostsMigrated?: boolean
/** Why: closing a terminal with child processes kills foreground work; keep this skip separate from other confirmations. */
skipCloseTerminalWithRunningProcessConfirm: boolean
/** Why: deleting an automation also deletes its run history; keep this skip separate from worktree deletion. */
skipDeleteAutomationConfirm: boolean
/** Why: deleting an artifact breaks a public link others may already hold; keep this skip separate from local deletions. */
skipDeleteArtifactConfirm: boolean
/** Why: a Codex rate-limit reset spends a scarce credit on the live account; keep this skip separate from local confirmations. */
skipCodexRateLimitResetConfirm: boolean
/** Default preset in the new-workspace GitHub task view. */
defaultTaskViewPreset: TaskViewPresetId
/** Persisted last-used task source so Tasks reopens to the same provider instead of defaulting to GitHub. */
defaultTaskSource: TaskProvider
/** Persisted visible task providers; hides unused providers from Tasks chrome and sidebar shortcuts. */
visibleTaskProviders: TaskProvider[]
/** Why: one-shot guard to make Jira visible for existing profiles once, without re-adding after a later opt-out. */
visibleTaskProvidersDefaultedForJira: boolean
/** Repo selection: null includes all present/future repos; arrays freeze a subset, dropping ineligible ids on load and treating empty as null. */
defaultRepoSelection: string[] | null
/** Linear team selection: null includes all; arrays freeze selected team IDs, matching defaultRepoSelection. */
defaultLinearTeamSelection: string[] | null
/** Session cookie for OpenCode Go rate-limit fetching. Stored encrypted. */
opencodeSessionCookie: string
/** Optional OpenCode Go workspace ID override; when set, skips the workspaces lookup and fetches usage directly. */
opencodeWorkspaceId: string
/** Optional MiniMax group id. When empty, the usage fetcher extracts minimax_group_id_v2 from the cookie. */
minimaxGroupId: string
/** Comma-separated MiniMax model names to show in the status bar usage window. */
minimaxUsageModels: string
/** MiniMax account region; defaults to overseas for existing users. */
minimaxEndpoint: MiniMaxEndpoint
/** GLM Coding Plan site whose API key is saved in AI Provider Accounts; defaults to the international Z.AI console. */
zcodePlanSite?: ZcodePlanSite
/** Extract OAuth credentials from the local Gemini CLI for rate-limit fetching. Off by default (explicit opt-in). */
geminiCliOAuthEnabled: boolean
/** Per-agent CLI command overrides. A missing key means use the catalog default binary name. */
agentCmdOverrides: Partial<Record<TuiAgent, string>>
/** Off keeps each Codex home's history to itself: Orca links no sessions between accounts or
* into ~/.codex, and removes nothing already linked (#24511). Absent means on (#10770). */
codexShareHistoryAcrossAccounts?: boolean
/** Custom CODEX_HOME for Codex session-history discovery (defaults to ~/.codex).
* History-only: does not change which account/config/hooks Orca uses. */
codexSessionSourceHome?: {
/** Absolute host path; empty/undefined falls back to ~/.codex. */
host?: string
/** Per-WSL-distro absolute Linux path; missing distro falls back to <wslHome>/.codex. */
wsl?: Record<string, string>
}
/** Per-agent default CLI arguments appended after the binary/path and before prompts. */
agentDefaultArgs?: Partial<Record<TuiAgent, string>>
/** Per-agent launch environment defaults used when yolo mode is exposed as env. */
agentDefaultEnv?: Partial<Record<TuiAgent, Record<string, string>>>
/** One-shot guard for adding yolo-mode default args to untouched agent launch profiles. */
agentYoloDefaultsMigrated?: boolean
/** Why: disabling must persist so startup doesn't reinstall global agent hook entries the user just removed. */
agentStatusHooksEnabled: boolean
/** Local agent-state-rules.json replaces downloaded/bundled rules for testing. */
agentStateRulesPath?: string | null
/** Off ignores downloads/cache and uses bundled rules or local override; absent means on. */
agentStateRulesLiveUpdates?: boolean
/** Pre-trust the worktree or folder Orca starts an agent in, so its "trust this folder?" prompt is skipped. Defaults on. */
agentWorkspaceTrustEnabled: boolean
/** Why: Codex's shared server runs every tab's hooks with the first tab's env; off opts new terminals back into it. Absent reads as on. */
codexTerminalServerIsolation?: boolean
/** Off hides the banner on a typed `codex` that joined Codex's shared server. Absent reads as on. */
codexSharedServerWarning?: boolean
/** Dismissed freshness tuples: no write authority, just suppress re-nudging the same official placement/revision. */
dismissedSkillFreshnessNudges?: string[]
/** Why: generated tab titles are subjective, so they stay opt-in and manual renames win. */
tabAutoGenerateTitle: boolean
/** Why: pinned tabs can still be closed via keyboard/native-menu; this gates that behind a confirmation. Defaults on. */
confirmClosePinnedTab: boolean
/** Why: preview tabs reuse one slot per group, so browsing replaces the open file; off makes every open its own tab. Defaults on. */
editorPreviewTabsEnabled: boolean
/** When true, Orca requests local awake assertions while hook-reported agents are working. */
keepComputerAwakeWhileAgentsRun: boolean
/** Optional for mixed-version compatibility; the legacy boolean maps true to Auto. */
computerAwakeMode?: ComputerAwakeMode
/** macOS Option: auto uses keyboard layout (US → Meta, others compose); false composes; true sends Meta on both keys; left/right select one.
* See docs/terminal-option-key-layout-aware-default.md. */
terminalMacOptionAsAlt: 'auto' | 'true' | 'false' | 'left' | 'right'
/** First upgrade resets ambiguous old true defaults to auto, restoring non-US input; guarded so later choices persist. */
terminalMacOptionAsAltMigrated: boolean
/** Whether macOS terminal input maps the physical JIS Yen (¥) key to backslash, per common terminal expectation. */
terminalJISYenToBackslash: boolean
experimentalMobile: boolean
/** Why: iOS Simulator is default-on for capable macOS hosts; this is the durable off switch (hides UI, blocks CLI attach). */
mobileEmulatorEnabled?: boolean
/** Preferred iOS Simulator UDID for UI auto-attach and agent CLI attach. */
mobileEmulatorDefaultDeviceUdid?: string | null
/** Explicit Android SDK root for when auto-discovery (ANDROID_HOME / default path) fails; null (default) auto-discovers. */
androidSdkPath?: string | null
/** Phone-fit PTY restore delay after the last mobile subscriber: null holds indefinitely; finite values clamp to 5s–60min. See docs/mobile-fit-hold.md. */
mobileAutoRestoreFitMs: number | null
/** New QR pairing: absent/automatic allows Relay + local; local-only restricts to same network. */
mobilePairingConnectionMode?: 'automatic' | 'local-only'
/** Explicit custom address restored when generating future mobile pairing codes. */
mobilePairingCustomAddress?: string | null
/** Saved custom addresses available in both mobile pairing pickers. */
mobilePairingCustomAddresses?: string[]
/** Name this runtime reports to paired clients; empty uses the host's detected name. */
machineName: string
/** Opt-in animated pet overlay; off unmounts it and renderer toggles apply immediately. */
experimentalPet: boolean
/** Legacy persisted key from before the sidekick -> pet rename; read only during migration, new writes use experimentalPet. */
experimentalSidekick?: boolean
/** Experimental: left-sidebar Agents view — threaded feed of agent completions, blocking/unread state, worktree creation. */
experimentalActivity: boolean
/** Experimental: pop-out Kanban dashboard for monitoring and opening agent terminals across worktrees. */
experimentalAgentDashboardPopout?: boolean
/** Set after the one-time legacy Agents tab introduction has been acknowledged. */
agentsSidebarIntroShown?: boolean
/** True when the profile previously opted into the legacy Agents view. */
agentsSidebarMigratedFromExperimental?: boolean
/** How the Agent Dashboard opens: an in-window companion board or a separate pop-out window. Defaults to in-window. */
experimentalAgentDashboardMode?: AgentDashboardMode
/** Includes stale quiet agents as a fourth Agent Dashboard column. */
experimentalAgentDashboardShowIdle?: boolean
/** One-shot migration guard for defaulting the Agents view off; later explicit opt-ins persist normally. */
experimentalActivityDefaultedOffForAllUsers?: boolean
/** Experimental: persistent terminal-pane attention ring for bell + agent-completion events. Opt-in while tuning signal/noise. */
experimentalTerminalAttention: boolean
/** Experimental: automatically sleep completed, resumable background agent terminals. */
experimentalAgentHibernation?: boolean
/** Milliseconds a completed agent must stay idle before hibernation can be considered. */
agentHibernationIdleMs?: number
/** Experimental: opt-in preview of the updated worktree-card layout and metadata behavior. */
experimentalNewWorktreeCardStyle?: boolean
/** Experimental: per-workspace on-demand environment recipes and setup surface. */
experimentalEphemeralVms?: boolean
/** Experimental (Windows): add WSL distros as hosts, each running its own Orca server. */
experimentalWslHosts?: boolean
/** Compact worktree cards: hide the metadata row when title and branch say the same thing. */
compactWorktreeCards: boolean
/** Legacy persisted key from the Experimental rollout; new writes use compactWorktreeCards. */
experimentalCompactWorktreeCards?: boolean
/** Active non-local runtime environment for client-routed RPC; null keeps local desktop behavior. */
activeRuntimeEnvironmentId?: string | null
/** GitHub Project pinned/recent/active/last-view state; persistence hydrates defaults for older profiles. */
githubProjects?: GitHubProjectSettings
/** AI commit-message config (agent, model, per-model thinking, prompt suffix). Optional to avoid migrating existing profiles. */
commitMessageAi?: CommitMessageAiSettings
/** Source-control AI generation settings for commit messages and hosted-review drafts. */
sourceControlAi?: SourceControlAiSettings
/** GitLab project preferences (pinned + recent paths). Optional for pre-GitLab profiles; persistence merge fills the default. */
gitlabProjects?: GitLabProjectSettings
/** Anonymous telemetry consent, identity, frozen experiments, and daily usage limits; optional before migration. */
telemetry?: TelemetrySettings
/** One-shot cohort marker for the tab-switch keybinding swap. 'pending' =
* pre-existing install (seed pins old chords, then flips to 'done'); 'done' = fresh install. */
tabSwitchKeybindingSeed?: 'pending' | 'done'
/** Voice/dictation settings; persistence merge hydrates getDefaultSettings() values for older profiles. */
voice?: VoiceSettings
/** Transcript full-text search consent + retention. Absent means off; nothing indexes until the user opts in. */
aiVaultSearch?: AiVaultSearchSettings
}
// Retain one import entry point while keeping feature shapes separate from the max-lines-limited settings module.
export type { GhosttyImportPreview } from './ghostty-import-preview'
export type { OrcaWorkspaceLayout } from './orca-workspace-layout'