Sessionsgenoprettelse

cmux gemmer formen på dit arbejde, så appen efter genstart kan hente de samme vinduer, workspaces, paneler, terminalkontekst og browserstatus tilbage.

Hvad cmux gendanner

Efter genstart gendanner cmux layout og metadata ejet af appen:

Vindues-, workspace- og panel-layout
Arbejdsmapper
Terminal-scrollback, best effort
Browser-URL og navigationshistorik

cmux checkpoint'er ikke vilkårlig live-processtatus. tmux, vim, shells og ikke-understøttede terminalapps åbner som normale terminaler, medmindre de har deres egen cmux resume-integration.

Genoptag agent-session

Understøttede AI-kodeagenter kan genoptages, når cmux har fanget agentens native session-ID. Installer hooks efter agent-CLI'en, så binæren findes på PATH:

cmux hooks setup
cmux hooks setup codex
cmux hooks setup grok
cmux hooks setup antigravity
cmux hooks setup omp
cmux hooks setup --agent opencode

cmux hooks setup installerer alle understøttede integrationer, den kan finde, og viser en oversigt over agenter, der blev sprunget over. Brug et agentnavn, når du kun vil have én integration.

Brugerdefinerede surface resume-kommandoer

Avancerede brugere og integrationer kan binde enhver terminal-surface til en restart-kommando. cmux gemmer bindinger oprettet via offentlig CLI eller socket til inspektion og manuel genoptagelse.

cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work

Godkendte præfikser kan gennemgås eller redigeres i Settings > Terminal > Resume Commands. cmux auto-kører kun resume-bindinger, som den markerer som betroede, for eksempel tmux-bindinger fundet fra live processer eller bruger-godkendte præfikser. cmux checkpoint'er stadig ikke vilkårlig proceshukommelse. Følsomme miljønøgler som tokens, adgangskoder, hemmeligheder og API-nøgler fjernes, før en resume-binding gemmes. Godkendelser bindes også til arbejdsmappen og præcise miljøværdier, når de findes.

Understøttede agenter

Agent	Binær	Resume-kommando	Feed-bro
Claude Code	`claude`	`claude --resume <id>`	PermissionRequest
Codex	`codex`	`codex resume <id>`	PreToolUse, PermissionRequest
Grok / Grok Build CLI	`grok`	`grok -r <id>`	PreToolUse
OpenCode	`opencode`	`opencode --session <id>`	plugin event bus
Pi	`pi`	`pi --session <id>`	ingen
OMP	`omp`	`omp --session <id>`	ingen
Amp	`amp`	`amp threads continue <id>`	ingen
Cursor CLI	`cursor-agent`	`cursor-agent --resume <id>`	beforeShellExecution
Gemini	`gemini`	`gemini --resume <id>`	PreToolUse
Antigravity CLI	`agy`	`agy --conversation <id>`	PreToolUse, PostToolUse
Rovo Dev	`acli`	`acli rovodev run --restore <id>`	ingen
Hermes Agent	`hermes`	`hermes --resume <id>`	pre_tool_call, post_tool_call, pre_approval_request, post_approval_response
Copilot	`copilot`	`copilot --resume <id>`	PreToolUse
CodeBuddy	`codebuddy`	`codebuddy --resume <id>`	PreToolUse
Factory	`droid`	`droid --resume <id>`	PreToolUse
Qoder	`qodercli`	`qodercli --resume <id>`	PreToolUse

Claude Code håndteres af cmux Claude-wrapperen, når Claude-integration er aktiveret i Settings. Antigravity accepterer også agy som setup-alias, og Rovo Dev accepterer rovo.

Manuel gendannelse

cmux gendanner det senest gemte snapshot ved normal start. Du kan også genanvende det forrige snapshot manuelt:

History > Restore Previous App Launch
⌘ ⇧ O
cmux restore-session

Slå automatisk agent-genoptagelse fra

For at gendanne paneler uden at starte gemte agent resume-kommandoer skal du slå Settings > Terminal > Resume Agent Sessions on Reopen fra eller sætte:

~/.config/cmux/cmux.json

{
  "terminal": {
    "autoResumeAgentSessions": false
  }
}

Dette slår kun agent resume-kommandoer fra. cmux gendanner stadig layout, arbejdsmapper, scrollback og browserhistorik.

Sådan virker det

cmux skriver et versioneret JSON-snapshot til ~/Library/Application Support/cmux/session-<bundle-id>.json samt en previous-session cache til manuel genåbning.
Terminal-scrollback gemmes som begrænset tekst og replayes via en midlertidig fil ved gendannelse. Det er best effort, fordi terminalapps kan gentegne eller rydde skærmen.
Agent hooks skriver ~/.cmuxterm/<agent>-hook-sessions.json med agent-session-ID, cmux workspace-ID, surface-ID, cwd, proces-ID når det findes, og en saniteret startkommando.
Ved gendannelse genopbygger cmux først vinduer og paneler. Hvis automatisk agent-genoptagelse er aktiveret, starter den en engangs-shellkommando, der kører agentens native resume-kommando med det gemte session-ID.

Den almindelige konfigurationsdokumentation dækker cmux.json. Sessionsgenoprettelse holder app-layout adskilt fra Ghostty-terminalens renderingsindstillinger.