Sesjongjenoppretting

cmux lagrer formen på arbeidet ditt slik at appen etter omstart kan hente tilbake de samme vinduene, workspaces, panelene, terminalkonteksten og nettlesertilstanden.

Hva cmux gjenoppretter

Etter omstart gjenoppretter cmux layout og metadata som appen eier:

Layout for vinduer, workspaces og paneler
Arbeidsmapper
Terminal-scrollback, best effort
Nettleser-URL og navigasjonshistorikk

cmux checkpoint-er ikke vilkårlig live prosesstilstand. tmux, vim, shell og terminalapper uten støtte åpnes som vanlige terminaler med mindre de har egen cmux resume-integrasjon.

Gjenoppta agentøkt

Støttede AI-kodeagenter kan gjenopptas når cmux har fanget agentens native session-ID. Installer hooks etter agent-CLI-en slik at binæren finnes 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 støttede integrasjoner den finner og skriver ut et sammendrag for agenter som ble hoppet over. Bruk et agentnavn når du bare vil ha én integrasjon.

Egendefinerte surface resume-kommandoer

Avanserte brukere og integrasjoner kan binde hvilken som helst terminal-surface til en restart-kommando. cmux lagrer bindinger laget via offentlig CLI eller socket for inspeksjon og manuell gjenopptakelse.

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

Godkjente prefikser kan gjennomgås eller redigeres i Settings > Terminal > Resume Commands. cmux auto-kjører bare resume-bindinger den markerer som klarerte, for eksempel tmux-bindinger oppdaget fra levende prosesser eller bruker-godkjente prefikser. cmux checkpoint-er fortsatt ikke vilkårlig prosessminne. Sensitive miljønøkler som tokens, passord, hemmeligheter og API-nøkler fjernes før en resume-binding lagres. Godkjenninger bindes også til arbeidsmappen og eksakte miljøverdier når de finnes.

Stø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 av cmux Claude-wrapperen når Claude-integrasjonen er aktivert i Settings. Antigravity godtar også agy som setup-alias, og Rovo Dev godtar rovo.

Manuell gjenoppretting

cmux gjenoppretter siste lagrede snapshot ved normal oppstart. Du kan også bruke forrige snapshot manuelt igjen:

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

Slå av automatisk agent-gjenopptakelse

For å gjenopprette paneler uten å starte lagrede agent resume-kommandoer, slå av Settings > Terminal > Resume Agent Sessions on Reopen eller sett:

~/.config/cmux/cmux.json

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

Dette slår bare av agent resume-kommandoer. cmux gjenoppretter fortsatt layout, arbeidsmapper, scrollback og nettleserhistorikk.

Slik fungerer det

cmux skriver et versjonert JSON-snapshot til ~/Library/Application Support/cmux/session-<bundle-id>.json, pluss en previous-session cache for manuell gjenåpning.
Terminal-scrollback lagres som begrenset tekst og spilles av via en midlertidig fil ved gjenoppretting. Dette er best effort fordi terminalapper kan tegne om eller tømme skjermen.
Agent hooks skriver ~/.cmuxterm/<agent>-hook-sessions.json med agent session-ID, cmux workspace-ID, surface-ID, cwd, prosess-ID når tilgjengelig og en sanert startkommando.
Ved gjenoppretting bygger cmux først opp vinduer og paneler. Hvis automatisk agent-gjenopptakelse er aktivert, starter den en engangs shell-kommando som kjører agentens native resume-kommando med lagret session-ID.

Vanlige konfigurasjonsdokumenter dekker cmux.json. Sesjongjenoppretting holder app-layout separat fra Ghostty-terminalens renderingsinnstillinger.