feat(accounts): keep a Claude or Codex agent on its account

docs/site/content/docs/agents/claude-code.mdx

@@ -22,6 +22,8 @@ Orca reads your local `~/.claude` usage state and shows current usage plus rate-
 
 Orca supports multiple Claude accounts and can swap between them in one click, matching the Codex flow. Switching accounts works even with live Claude sessions running — Orca holds the in-progress switch behind a guard so you don't trigger overlapping auth refreshes. See [Hot-swap Codex accounts](/docs/agents/codex-hot-swap) — the Claude flow is identical in shape.
 
+You can also keep one Claude agent on its account from its tab's right-click menu, so switching moves the others but not it: when Orca offers to restart Claude sessions still running on the old account, it leaves kept agents out. Orca then starts that conversation on the kept account whenever it restores, wakes or resumes it. If you keep an agent after it started, a `claude` you type again in that same terminal still follows the selected account; the tab's hover card says "Kept on this account from its next start" until Orca starts it again.
+
 ## Subagents and teams
 
 Background subagents and Agent Teams teammates can show as expandable child rows under the lead agent in the worktree agent list and [Agent Dashboard](/docs/model/agents-sessions#agent-dashboard). Selecting a child focuses the lead terminal.

docs/site/content/docs/agents/codex-hot-swap.mdx

@@ -15,6 +15,14 @@ Running multiple Codex accounts to maximize tokens is common. Orca lets you hot-
 
 Click the Codex chip in the status bar to open the account switcher. Pick an account; any new Codex session launched after that uses it. Sessions already running keep their original account until restarted.
 
+## Keep an agent on its account
+
+Hover a Codex or Claude tab to see which account each agent in it runs on. To keep one agent on its account while you switch the others, right-click its tab and check **Keep on** followed by the account's name (a split tab has one item per agent). Answering the **Account switched** prompt with **Keep old account** does the same.
+
+A kept agent stays on its account when you switch accounts, and every start Orca makes of its conversation — after a restart of Orca, when the agent wakes, or when you resume it from Session History — runs on that account. Agents you don't keep follow the selected account exactly as before. The account switcher shows how many terminal agents run on each account.
+
+Uncheck the item to let the agent follow the selected account again; this also works for an agent Orca refused to start on its kept account. Removing an account releases the agents kept on it. A `claude` you type in a Claude terminal kept on a removed account does not run; open a new terminal instead.
+
 ## System default
 
 The **System default** row is your current host Codex login under `~/.codex`. Managed accounts (added in Orca) do not rewrite that login; they run in isolated homes. Select System default when you want launches to match a terminal `codex` outside Orca.
@@ -29,6 +37,7 @@ For managed Codex accounts, Orca mirrors settings from your real `~/.codex/confi
 - Existing Codex processes keep their current account until restart.
 - Usage readouts in the status bar follow the currently-active account.
 - The restart chip preserves the active account at the time of restart.
+- Keep is not offered for a Codex agent started while `CODEX_HOME` was set, or for terminals in WSL or on a remote host.
 
 ## Claude Code accounts
 

src/main/agent-accounts/agent-account-keep-wiring.ts

@@ -0,0 +1,26 @@
+import { agentHookServer } from '../agent-hooks/server'
+import { getCodexPaneAccount, setCodexPaneKept } from '../codex/codex-pane-account-registry'
+import { keepStaleCodexPanes } from '../codex/codex-stale-pane-accounts'
+import { getPtyIdForPaneKey, ptyPaneKey } from '../ipc/pty/pane/key-state'
+import type { AgentKeepDeps } from './agent-account-keep'
+import { getAgentRunAccounts, getKeptAgentConversations } from './agent-run-accounts-installed'
+
+/** Null where the producer is not installed (orcad): there, keeping is not offered. */
+export function installedAgentKeepDeps(): AgentKeepDeps | null {
+  const producer = getAgentRunAccounts()
+  const kept = getKeptAgentConversations()
+  if (!producer || !kept) {
+    return null
+  }
+  return {
+    getRow: (paneKey) => agentHookServer.getRunAccountRow(paneKey),
+    refresh: (paneKey) => producer.refresh(paneKey),
+    withdraw: (paneKey) => producer.withdraw(paneKey),
+    kept,
+    getPtyIdForPaneKey,
+    getPaneKeyForPty: (ptyId) => ptyPaneKey.get(ptyId),
+    readCodexRecord: getCodexPaneAccount,
+    setCodexPaneKept,
+    keepStaleCodexPanes
+  }
+}