Configure storage first
Install the release, configure the BOS bucket and credentials, then run `celagent doctor` and `celagent cas-probe` before relying on recovery.
celagent · Pi terminal agent
Resume on another device
Use Pi’s terminal interface with sessions saved on BOS. Restore the history by session ID on another machine configured for the same storage.
$ celagent
COMMANDS
-
celagent -
celagent list -
celagent <id> # restore from BOS -
celagent task ledger
persistence Completed turns → BOS write queue → restore by session ID after a successful write
Configure both machinesConditional writes detect conflicts
Persistence model
Successful writes can be recovered
Completed turns are queued for BOS with conditional writes. A successful write makes the session recoverable on another configured machine.
- 01
Native session history
sessions/<id>.jsonl stores Pi history, including tool calls and branches. Older JSON sessions use a legacy text recovery path.
- 02
Conflicts and failures
Conditional writes detect conflicting updates. Retryable write failures remain queued; a BOS timeout or permission error does not silently fall back to truncated cache.
Configure, save, resume
Configure, save, resume
Save at the end of a turn
Completed turns enter the BOS write queue with conditional writes for conflict handling. Retryable network failures remain queued; cross-machine recovery requires a successful write.
Resume a saved session
Run `celagent list`, then `celagent <id>` on another configured machine. Recovery reads BOS first; only a missing object falls back to the worker cache.
Beyond conversation history
Distributed tasks
celagent task submitcelagent task statuscelagent task ledger
Celld tasks have checkpoint recovery and an idempotent task ledger. See the repository for setup and command details.
Recovery and Pi
Recovery and Pi
A saved conversation is not a synced workspace
Session recovery does not set up the project files or environment on the other machine. Wait for the BOS write to succeed before relying on remote recovery.
Pi engine and installation
celagent reuses the Pi engine and its tools. Install from the GitHub release with install.sh, or install.ps1 on Windows; upstream Celld has no Windows package.