Oturum geri yükleme

cmux çalışmanızın şeklini kaydeder, böylece app yeniden açıldığında aynı pencereler, workspace'ler, paneller, terminal context'i ve tarayıcı durumu geri gelir.

cmux neleri geri yükler

Yeniden açıldıktan sonra cmux app'e ait layout ve metadata'yı geri yükler:

Pencere, workspace ve panel layout'u
Çalışma dizinleri
Terminal scrollback, best effort
Tarayıcı URL'si ve gezinme geçmişi

cmux rastgele live process durumunu checkpoint etmez. tmux, vim, shell'ler ve desteklenmeyen terminal app'leri kendi cmux resume integration'ları yoksa normal terminal olarak yeniden açılır.

Agent oturumu resume

Desteklenen AI coding agent'ları, cmux agent'ın native session ID'sini yakaladığında resume edebilir. Agent CLI kurulduktan sonra binary PATH üzerinde olacak şekilde hooks kurun:

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 bulduğu tüm desteklenen integration'ları kurar ve atlanan agent'lar için özet yazar. Sadece tek integration istediğinizde agent adı kullanın.

Özel surface resume komutları

Gelişmiş kullanıcılar ve integration'lar herhangi bir terminal surface'ini restart komutuna bağlayabilir. cmux public CLI veya socket ile oluşturulan binding'leri inceleme ve manuel resume için saklar.

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

Onaylanan prefixler Settings > Terminal > Resume Commands içinde incelenebilir veya düzenlenebilir. cmux yalnızca güvenilir olarak işaretlediği resume binding'lerini otomatik çalıştırır, örneğin canlı processlerden algılanan tmux binding'leri veya kullanıcı onaylı prefixler. cmux rastgele process memory'yi hâlâ checkpoint etmez. Token, parola, gizli değer ve API anahtarı gibi hassas ortam anahtarları resume binding kaydedilmeden önce atılır. Onaylar, varsa çalışma dizinine ve tam ortam değerlerine de bağlanır.

Desteklenen agent'lar

Agent	Binary	Resume komutu	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>`	yok
OMP	`omp`	`omp --session <id>`	yok
Amp	`amp`	`amp threads continue <id>`	yok
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>`	yok
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, Settings'te Claude integration etkinse cmux Claude wrapper tarafından işlenir. Antigravity setup alias olarak agy'yi de kabul eder, Rovo Dev ise rovo'yu kabul eder.

Manuel geri yükleme

cmux normal açılışta son kaydedilen snapshot'ı geri yükler. Önceki snapshot'ı manuel olarak da tekrar uygulayabilirsiniz:

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

Otomatik agent resume'u kapat

Kaydedilmiş agent resume komutlarını başlatmadan panelleri geri yüklemek için Settings > Terminal > Resume Agent Sessions on Reopen seçeneğini kapatın veya şunu ayarlayın:

~/.config/cmux/cmux.json

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

Bu yalnızca agent resume komutlarını kapatır. cmux layout, çalışma dizinleri, scrollback ve tarayıcı geçmişini geri yüklemeye devam eder.

Nasıl çalışır

cmux version'lı JSON snapshot'ı ~/Library/Application Support/cmux/session-<bundle-id>.json dosyasına ve manuel reopen için previous-session cache'e yazar.
Terminal scrollback sınırlı metin olarak saklanır ve geri yüklemede geçici dosya üzerinden replay edilir. Terminal app'leri ekranı yeniden çizebildiği veya temizleyebildiği için bu best effort'tur.
Agent hooks ~/.cmuxterm/<agent>-hook-sessions.json dosyasına agent session ID, cmux workspace ID, surface ID, cwd, varsa process ID ve sanitize edilmiş launch command yazar.
Geri yüklemede cmux önce pencereleri ve panelleri yeniden kurar. Otomatik agent resume açıksa, kaydedilen session ID ile agent'ın native resume komutunu çalıştıran tek seferlik shell komutu başlatır.

Normal configuration docs cmux.json'u kapsar. Session restore app layout'unu Ghostty terminal rendering ayarlarından ayrı tutar.