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 { JiraQuickFilterState } from './jira/jira-quick-filters'
import type { BrowserDevToolsDockLayout } from './browser-devtools-dock'
import type { JiraSavedFilterState } from './jira/jira-saved-filters'
import type { ReleaseChannel } from './release-channel'
import type { WorkspaceCleanupUIState } from './workspace-cleanup'
import type { FeatureTipId } from './feature-tips'
import type { ContextualTourId } from './contextual-tours'
import type { FeatureInteractionState } from './feature-interactions'
import type { UsagePercentageDisplay } from './usage-percentage-display'
import type { StatusBarUsageMode } from './status-bar-usage-mode'
import type { PersistedTrustedOrcaHooks } from './orca-yaml-hook-types'
import type { CustomPet } from './pet-types'
import type {
ActivityGroupBy,
AgentActivityDisplayMode,
ManualRepoOrderEntry,
ProjectOrderBy,
RightSidebarExplorerView,
RightSidebarTab,
StatusBarItem,
TaskResumeState,
ThreadReadFilter,
TopLevelView,
VisibleWorkspaceHostIds,
WorkspaceHostOrder,
WorkspaceHostScope,
WorktreeCardProperty
} from './ui-chrome-types'
import type { WorkspaceStatusDefinition } from './worktree/types'
import type { PersistedAutomationHostFilter } from './automation-host-filter'
import type { PendingRuntimeRepoRemoval } from './pending-runtime-repo-removal'
export type PersistedUIState = {
/** Paired-server project removals still owed to their server; optional so older builds ignore it. */
pendingRuntimeRepoRemovals?: PendingRuntimeRepoRemoval[]
jiraSavedFilterState?: JiraSavedFilterState
jiraQuickFilterState?: JiraQuickFilterState
lastActiveRepoId: string | null
lastActiveWorktreeId: string | null
/** Active top-level view at save time, restored on relaunch; sanitized to 'terminal' if unknown or now-gated. */
activeView: TopLevelView
sidebarWidth: number
sidebarOpen?: boolean
rightSidebarOpen: boolean
rightSidebarTab: RightSidebarTab
rightSidebarExplorerView: RightSidebarExplorerView
rightSidebarWidth: number
markdownTocPanelWidth?: number
combinedDiffFileTreeWidth?: number
groupBy: 'none' | 'workspace-status' | 'repo' | 'pr-status'
sortBy: 'name' | 'smart' | 'recent' | 'repo' | 'manual'
/** Project-header order in repo grouping, independent of workspace sort: manual permits drag, recent follows visible activity. */
projectOrderBy: ProjectOrderBy
/** Deprecated; the Active only filter is retired and ignored on hydration. */
showActiveOnly: boolean
/** Hide sleeping/inactive workspaces from workspace navigation. Off by default. */
hideSleepingWorkspaces?: boolean
/** Which execution hosts the sidebar shows; `all` = mixed view, specific IDs focus without tearing down other hosts' sessions. */
workspaceHostScope?: WorkspaceHostScope
/** Which execution hosts the sidebar shows; `null` = sticky all-hosts so new hosts appear automatically. */
visibleWorkspaceHostIds?: VisibleWorkspaceHostIds
/** User-defined sidebar order for host sections; missing/new hosts append in discovered order. */
workspaceHostOrder?: WorkspaceHostOrder
/** Automations page host filter. Stores only a canonical host key; invalid values degrade to all hosts. */
automationHostFilter?: PersistedAutomationHostFilter
/** Desktop-owned all-host repo order; host-qualified identities keep a manual cross-host interleaving while each host owns its local permutation. */
manualRepoOrder?: ManualRepoOrderEntry[]
/** Deprecated legacy positive-form setting. Ignored on hydration. */
showSleepingWorkspaces?: boolean
/** Deprecated legacy name used by a short-lived build. Ignored on hydration. */
showInactiveWorkspaces?: boolean
/** Hide the repo's checked-out branch from workspace nav (sidebar, Cmd+J); folder-mode repos are unaffected (empty-branch worktrees excluded). */
hideDefaultBranchWorkspace: boolean
/** Hide workspaces created by automation new-per-run dispatches. */
hideAutomationGeneratedWorkspaces?: boolean
/** Hide workspaces created through `orca worktree create`. */
hideCliCreatedWorkspaces?: boolean
/** Hide workspaces sitting on a detached HEAD; folder workspaces (no head at all) are unaffected. */
hideDetachedHeadWorkspaces?: boolean
/** Hide workspaces with known provenance from another paired device or the host UI. */
hideWorkspacesFromOtherDevices?: boolean
/** Keep each project's main workspace out of the "Hide sleeping" sweep. Absent means on (#8873). */
alwaysShowDefaultBranchWorkspace?: boolean
/** Per-worktree Explorer dotfile visibility. Missing entries inherit the default: show. */
_explorerDisplayRootMigrated?: boolean
explorerDisplayRootByWorktree?: Record<string, string>
showDotfilesByWorktree?: Record<string, boolean>
filterRepoIds: string[]
/** Agents host scope stays separate from navigation filters; null means all hosts. */
agentsVisibleHostIds?: VisibleWorkspaceHostIds
/** Agents-view project filter; empty = all projects. Separate from filterRepoIds (workspace nav). */
agentsFilterRepoIds?: string[]
/** Agents-view workspace-origin filters; separate from the workspace-nav hide flags. Absent means off. */
agentsHideWorkspacesFromOtherDevices?: boolean
agentsHideAutomationGeneratedWorkspaces?: boolean
agentsHideCliCreatedWorkspaces?: boolean
/** Agents-view: include child (orchestration-dispatched) agent threads. Absent means off. */
agentsShowChildAgents?: boolean
/** Agents-view compact thread rows. Absent means on. */
agentsCompactMode?: boolean
/** Agents sidebar search field visibility. Absent means on. */
agentsShowSearch?: boolean
/** Agents-view unread-only thread filter. Absent means 'all'. */
agentsReadFilter?: ThreadReadFilter
/** Agents-view thread grouping. Absent means 'status'. */
agentsGroupBy?: ActivityGroupBy
collapsedGroups: string[]
uiZoomLevel: number
editorFontZoomLevel: number
worktreeCardProperties: WorktreeCardProperty[]
/** One-shot migration flag for deriving card properties from the two worktree card modes. */
_worktreeCardModeDefaulted?: boolean
showAgentModels?: boolean
agentActivityDisplayMode?: AgentActivityDisplayMode
workspaceStatuses?: WorkspaceStatusDefinition[]
workspaceBoardOpacity?: number
workspaceBoardColumnWidth?: number
syncTaskStatusFromWorkspaceBoard?: boolean
/** Migrate reversed defaults once; never infer later user order from IDs/labels. */
_workspaceStatusesDefaultOrderMigrated?: boolean
/** One-shot repair flag for the exact default payload a short-lived build persisted in reverse workflow order. */
_workspaceStatusesReorderedDefaultRepaired?: boolean
/** One-shot migration flag for default status workflow labels/visuals; only exact legacy defaults migrate, customized statuses preserved. */
_workspaceStatusesDefaultWorkflowMigrated?: boolean
/** One-shot migration flag for the old default status visuals; once stamped, user-authored colors/icons are preserved. */
_workspaceStatusesDefaultVisualsMigrated?: boolean
/** One-shot migration flag for adding the default-on Ports status item. */
_portsStatusBarDefaultAdded?: boolean
/** One-shot migration flag for adding the default-on Kimi status item. */
_kimiStatusBarDefaultAdded?: boolean
/** One-shot migration flag for adding the default-on MiniMax status item. */
_minimaxStatusBarDefaultAdded?: boolean
/** One-shot migration flag for adding the default-on Antigravity status item. */
_antigravityStatusBarDefaultAdded?: boolean
/** One-shot migration flag for adding the default-on Grok status item. */
_grokStatusBarDefaultAdded?: boolean
/** One-shot migration flag for adding the default-on Cursor status item. */
_cursorStatusBarDefaultAdded?: boolean
/** One-shot migration flag for adding the default-on ZCode status item. */
_zcodeStatusBarDefaultAdded?: boolean
statusBarItems: StatusBarItem[]
statusBarVisible: boolean
/** Why: this is client-side presentation, not a provider/account or execution-host setting. */
usagePercentageDisplay?: UsagePercentageDisplay
/** Client-side footer presentation; verbose preserves the pre-roster all-window default. */
statusBarUsageMode?: StatusBarUsageMode
dismissedUpdateVersion: string | null
/** Version when the sign-out notice was seen or dismissed; any value suppresses future appearances. */
dismissedUnexpectedSignoutVersion?: string | null
lastUpdateCheckAt: number | null
/** Dev-only update channel override; absent means the build's own channel. */
releaseChannelOverride?: ReleaseChannel | null
pendingUpdateNudgeId?: string | null
dismissedUpdateNudgeId?: string | null
/** Whether Orca already tried triggering the macOS notification permission dialog; prevents re-firing every launch. */
notificationPermissionRequested?: boolean
/** Once the "your sessions won't be interrupted" reassurance card is seen, never show it again. */
updateReassuranceSeen?: boolean
/** Renderer ui:set acknowledgments by pane/turn timestamp; persist so seen rows stay read after restart. */
acknowledgedAgentsByPaneKey?: Record<string, number>
/** Renderer ui:set cutoffs hide events at/before the timestamp; persist so cleared rows stay hidden after restart. */
activityClearedAtByPaneKey?: Record<string, number>
/** Renderer ui:set explicit unread turn stamps survive restart alongside acknowledgments and cutoffs. */
manuallyUnreadTurnsByPaneKey?: Record<string, number>
/** User-hidden setup-guide sidebar entry; a reversible declutter pref (Help menu stays available), not completion. */
setupGuideSidebarDismissed?: boolean
/** One-shot marker for the browser setup-guide milestone; profiles missing it are evaluated once in the renderer (completion needs runtime probes). */
setupGuideBrowserMilestoneMigrated?: boolean
/** Existing users who completed/dismissed the pre-browser checklist stay complete after the browser milestone is added. */
setupGuideBrowserMilestoneLegacyComplete?: boolean
/** User-dismissed browser import toolbar hint; import stays available from Settings > Browser and the overflow menu. */
browserImportHintHidden?: boolean
/** Why: Windows-only. Set once on first hide to tray so the "Orca is still running" notice shows only once. */
trayMinimizeNoticeShown?: boolean
/** Set by the OSC 52 default-on migration when it overrode a persisted `false`; the renderer shows one notice and clears it. */
osc52ClipboardDefaultOnNoticePending?: boolean
/** User dismissed the first-run Mobile Emulator intro; reversible only by re-enabling the feature in Settings. */
mobileEmulatorTabIntroDismissed?: boolean
/** User deferred the in-pane Mobile Emulator CLI + skill setup guide. */
mobileEmulatorAgentSetupDismissed?: boolean
/** One-shot rollout notice for manual project ordering default; absent or true keeps the sidebar callout hidden. */
projectOrderManualDefaultNoticeDismissed?: boolean
/** One-shot notice that usage meters show percent used, not remaining; absent resolves on load (new profiles dismissed, upgraded see it once). */
usagePercentageDisplayChangeNoticeDismissed?: boolean
/** One-time Compact notice; load decides eligibility before filling missing preferences. */
statusBarCompactChangeNoticeDismissed?: boolean
/** User dismissed the Alpha notice at the top of Settings > Plugins. */
pluginsAlphaNoticeDismissed?: boolean
/** User-hidden empty-state usage CTA; permanently hides the "Connect AI accounts" prompt even if providers are later disconnected. */
usageEmptyStateDismissed?: boolean
/** One-shot toast announcing per-terminal Codex servers; set when shown, so absent means not yet seen. */
codexTerminalServerIsolationNoticeSeen?: boolean
/** Windows one-shot toast for Codex moving onto ~/.codex; set when shown, so absent means not yet seen. */
codexSharedSettingsNoticeSeen?: boolean
/** One-shot pane banner explaining Claude Code's own diff panel; set when the user closes it. */
claudeDiffPanelNoticeSeen?: boolean
/** Retired one-shot Claude sign-in toast; kept because a paired client from that build still sends it. */
claudeAccountSignInNoticeSeen?: boolean
/** URL for new browser tabs; null = blank tab. */
browserDefaultUrl?: string | null
browserDefaultSearchEngine?: 'google' | 'duckduckgo' | 'bing' | 'kagi' | null
/** Electron browser zoom level applied when a new local browser tab is created. */
browserDefaultZoomLevel?: number
/** Optional Kagi private-session link used only when Kagi is the search engine. */
browserKagiSessionLink?: string | null
/** Side and size of DevTools docked in a browser pane; one choice for every page, like Chrome. */
browserDevToolsDock?: BrowserDevToolsDockLayout
/** Saved window bounds so the app restores last position/size instead of maximizing each launch. */
windowBounds?: { x: number; y: number; width: number; height: number } | null
/** Whether the window was maximized when it was last closed. */
windowMaximized?: boolean
/** Dashboard popout bounds, independent of main-window bounds. */
dashboardPopoutBounds?: { x: number; y: number; width: number; height: number } | null
/** Migrate legacy recent→smart once so later activity-based recent selections survive. */
_sortBySmartMigrated?: boolean
/** Rollback field only: every load stamps it, so it cannot gate migration; use _inlineAgentsDefaultedForAllUsers. */
_inlineAgentsDefaultedForExperiment?: boolean
/** One-shot flag for the inline-agents default-on rollout; distinct from _inlineAgentsDefaultedForExperiment, which was stamped every load and is permanently dirty. */
_inlineAgentsDefaultedForAllUsers?: boolean
/** One-shot migration flag for split-out card properties, set once so later deliberate unchecks of Linear issue/Ports stick across restarts. */
_expandedWorktreeCardPropertiesDefaulted?: boolean
/** One-shot backfill flag for 'jira-issue', which joined the defaults after the expansion migration had already stamped upgraded profiles. */
_jiraIssueWorktreeCardPropertyDefaulted?: boolean
/** One-shot backfill flag for 'host', which became a toggleable property after earlier profiles were already stamped. */
_hostWorktreeCardPropertyDefaulted?: boolean
/** Agent total when the star countdown began or was deferred; preserved across app updates. */
starNagBaselineAgents?: number | null
/** Legacy baseline version retained for older builds; no longer resets the countdown. */
starNagAppVersion?: string | null
/** Next agents-since-baseline threshold that fires the star-nag; starts at 35, doubles per dismissal without starring. */
starNagNextThreshold?: number
/** Once the user has starred Orca (any entry point), permanently suppress the nag. */
starNagCompleted?: boolean
/** Timestamp until which nonterminal dismissals suppress threshold prompts (force-show bypasses for dev/testing). */
starNagDeferredUntil?: number | null
/** Version that consumed the one-time value-moment ask; any saved version suppresses future attempts. Main-owned. */
starNagAgentValueMomentAppVersion?: string | null
trustedOrcaHooks?: PersistedTrustedOrcaHooks
setupScriptPromptDismissedRepoIds?: string[]
/** Pet overlay visibility, separate from the experimentalPet settings flag so "Hide pet" is a reversible dismiss; absent = true. */
petVisible?: boolean
/** Active pet id (bundled id or custom UUID); unknown ids fall back to the default on read so a removed custom pet doesn't blank the overlay. */
petId?: string
/** Metadata index for user-uploaded pet images; bytes live under legacy userData/sidekicks/custom/. */
customPets?: CustomPet[]
/** Pet overlay size in CSS pixels (square); clamped to [PET_SIZE_MIN, PET_SIZE_MAX] on read. */
petSize?: number
/** Legacy keys from before the sidekick -> pet rename; read only during migration, new writes use pet* above. */
sidekickVisible?: boolean
sidekickId?: string
customSidekicks?: CustomPet[]
sidekickSize?: number
/** Page-position state for Tasks: only transient tabs/searches (source/repo/team/project selections use their own settings paths). */
taskResumeState?: TaskResumeState
workspaceCleanup?: WorkspaceCleanupUIState
/** Feature tips already surfaced; startup opens the tips modal only when a current tip id is missing here. */
featureTipsSeenIds?: FeatureTipId[]
/** Feature ids the user has actually used; education surfaces skip teaching already-discovered features. */
featureInteractions?: FeatureInteractionState
/** Contextual tours already surfaced; unknown ids ignored on hydration for downgrade/upgrade forward-compat. */
contextualToursSeenIds?: ContextualTourId[]
/** Whether this profile may receive automatic contextual tours; missing = renderer hasn't classified the profile yet. */
contextualToursAutoEligible?: boolean
}