plain-language glossary

what is session persistence?

TL;DR

Session persistence means coming back to work without rebuilding it by hand, but the term covers different guarantees. Detaching keeps live processes running; a restart brings back your layout and lets supported agents resume their conversations; a sleeping host runs nothing; and a stopped cloud VM keeps its disk but not its processes. After a restart, Pane restores your panes, tabs and terminal output, and Claude Code, Codex, Cursor and OpenCode resume their conversations.

Session persistence means you can come back to work without rebuilding everything by hand. That sentence hides several different guarantees. A detached live process, a saved workspace layout, an agent conversation restored after a restart, and a persistent cloud disk are different things. Know which one your tool actually provides.

four persistence cases

casewhat remainswhat to expect
detach and reattachclient leaves; host keeps the server and processes aliveHerdr's strongest path; original processes keep running
app or server restartsaved session and worktree state returns; processes need recoverylayout returns; supported agents can resume native sessions
host sleepnothing executes while the host sleeps; use qualified awake-host setupprocesses pause until the host wakes
cloud volume stop/startrepos, worktrees, and config can persist on the volumedisk data returns; running processes don't

detach is the easy case

Detach means the client stops displaying the session while the host keeps it alive. tmux, Zellij, and Herdr use this model. You can close a terminal or lose an SSH connection, then reattach while the original shell or agent is still running.

  • → the host stays awake
  • → the server stays running
  • → the original process keeps its memory and state
  • → reattach shows the live session

restart means recovery

When an app or session server restarts, the old process may be gone. A tool can still restore the saved workspace shape, working directory, focus, and recent screen. Some agents expose their own session IDs, so an integration can resume the conversation. A generic shell or unsupported process starts fresh.

  • → layout restore isn't process restore
  • → screen history isn't a live shell
  • → native agent resume depends on the agent and integration
  • → a crashed agent can still need a human or an orchestrator to continue it

sleep is a host power question

No session layer can make a sleeping computer run code. If you need unattended progress, keep the host awake with a qualified power setup or use an always-on machine. Pane documents idle-sleep and lid-closed setup separately. Its optional Pane Chat resilience can help resume a turn that died during a sleep or network error, but it's recovery, not dark-wake execution.

  • → idle-sleep prevention is different from lid-closed setup
  • → battery sleep can pause work
  • → a crash or lost network can end an agent turn
  • → recovery tooling can continue a task after the host returns

cloud storage isn't process immortality

A cloud workspace volume can keep repositories, worktrees, configuration, and history across a VM stop and start. That protects data. It doesn't keep a shell, test, or agent process alive while the VM is stopped. Start the machine, reconnect the client, and recover the session when needed.

  • → volume persistence protects files
  • → an always-on VM protects live execution
  • → snapshots help before destructive changes
  • → remote clients still depend on a reachable host

how to choose the guarantee you need

Use this quick check before you leave an agent running.

  1. 1For a short network drop, use a live server and reattach. Herdr, tmux, and Zellij are built around this path.
  2. 2For a laptop restart, check whether your tool restores layout, screen history, or the agent's native conversation.
  3. 3For overnight work, keep the host awake while plugged in or move the runtime to an always-on remote machine.
  4. 4For cloud stop/start, verify volume persistence and plan to restart processes after the VM returns.
  5. 5For a failed agent turn, inspect the last output and continue only after you know what the agent was waiting on.

Sources

Corrections
Si quelque chose ici est faux ou obsolète, dites-le-nous. Nous corrigerons et mettrons à jour la date en haut de la page. Ouvrir une issue sur GitHub
Sources

questions fréquentes

ou
Télécharger*
Alerte Windows SmartScreenLes téléchargements directs peuvent afficher une alerte SmartScreen tant que Pane n'est pas signé. Pane est entièrement open source. Vous pouvez vérifier le code et le compiler vous-même.1. Cliquez sur Informations complémentaires2. Cliquez sur Exécuter quand même3. Continuez l'installationL'installation PowerShell télécharge directement la version officielle et évite la plupart des blocages du navigateur.installation globale npm
Collez cette commande dans PowerShell.Linux

Par Parsa Khazaeepoul, cofondateur de Pane. .