# Obnova sesije

cmux čuva oblik tvog rada kako bi ponovno pokretanje aplikacije vratilo iste prozore, workspaceove, paneove, terminalski kontekst i stanje browsera.

## Šta cmux obnavlja

Nakon ponovnog pokretanja cmux obnavlja layout i metapodatke kojima upravlja aplikacija:

-   Layout prozora, workspaceova i paneova
-   Radne direktorije
-   Terminalski scrollback, best effort
-   Browser URL i historiju navigacije

cmux ne checkpointuje proizvoljno stanje živih procesa. tmux, vim, shellovi i nepodržane terminalske aplikacije ponovno se otvaraju kao obični terminali osim ako imaju vlastitu cmux resume integraciju.

## Nastavak agent sesije

Podržani AI coding agenti mogu nastaviti kada cmux uhvati nativni session ID agenta. Instaliraj hooks nakon agent CLI-ja kako bi binarij bio na PATH:

```
# all integrations cmux can find on PATH
cmux hooks setup

# or one agent at a time
cmux hooks setup antigravity
cmux hooks setup codex
cmux hooks setup grok
cmux hooks setup omp
cmux hooks setup --agent opencode
```

cmux hooks setup instalira sve podržane integracije koje pronađe i ispisuje sažetak preskočenih agenata. Navedi ime agenta kada želiš samo jednu integraciju.

## Prilagođene surface resume komande

Napredni korisnici i integracije mogu vezati bilo koju terminalsku surface za restart komandu. cmux čuva bindinge napravljene javnim CLI-jem ili socketom za pregled i ručni nastavak.

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

Odobreni prefiksi mogu se pregledati ili urediti u Settings > Terminal > Resume Commands. cmux automatski pokreće samo resume bindinge koje označi pouzdanim, poput tmux bindinga otkrivenih iz živih procesa ili prefiksa koje je odobrio korisnik. cmux i dalje ne checkpointuje proizvoljnu memoriju procesa. Osjetljivi ključevi okruženja, poput tokena, lozinki, tajni i API ključeva, odbacuju se prije spremanja resume bindinga. Odobrenja se također vežu za radni direktorij i tačne vrijednosti okruženja kada postoje.

## Podržani agenti

| Agent | Binarij | Resume komanda | Feed bridge |
| --- | --- | --- | --- |
| 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>` | nema |
| OMP | `omp` | `omp --session <id>` | nema |
| Campfire | `campfire` | `campfire --session <id>` | nema |
| Amp | `amp` | `amp threads continue <id>` | nema |
| 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>` | nema |
| 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 obrađuje cmux Claude wrapper kada je Claude integracija uključena u Settings. Antigravity prihvata i agy kao setup alias, a Rovo Dev prihvata rovo.

## Ručna obnova

cmux pri normalnom pokretanju obnavlja zadnji sačuvani snapshot. Prethodni snapshot možeš ponovno primijeniti i ručno:

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

## Isključi automatski nastavak agenata

Za obnovu paneova bez pokretanja sačuvanih agent resume komandi, isključi Settings > Terminal > Resume Agent Sessions on Reopen ili postavi:

~/.config/cmux/cmux.json

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

Ovo isključuje samo agent resume komande. cmux i dalje obnavlja layout, radne direktorije, scrollback i historiju browsera.

## Kako radi

1.  cmux piše verzionisani JSON snapshot u ~/Library/Application Support/cmux/session-<bundle-id>.json, plus cache prethodne sesije za ručno ponovno otvaranje.
2.  Terminalski scrollback čuva se kao ograničen tekst i pri obnovi se replaya kroz privremenu datoteku. Ovo je best effort jer terminalske aplikacije mogu ponovo nacrtati ili obrisati ekran.
3.  Agent hooks pišu ~/.cmuxterm/<agent>-hook-sessions.json s agent session ID-jem, cmux workspace ID-jem, surface ID-jem, cwd, PID-om kada je dostupan i sanitizovanom launch komandom.
4.  Pri obnovi cmux prvo rekonstruira prozore i paneove. Ako je automatski nastavak agenata uključen, pokreće jednokratnu shell komandu koja izvršava nativnu resume komandu agenta sa sačuvanim session ID-jem.

Redovna [dokumentacija konfiguracije](https://cmux.com/bs/docs/configuration) pokriva cmux.json. Obnova sesije drži layout aplikacije odvojen od Ghostty terminal rendering postavki.

Canonical: https://cmux.com/bs/docs/session-restore

Documentation index: https://cmux.com/llms.txt