Pi, unchanged
Its terminal interface, engine, and tools; history stays native JSONL.
celagent · Pi terminal agent
Resume on another device.
Pi’s terminal. Sessions on BOS. Resume on a configured machine.
$ 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
Every turn is saved to BOS.
Saved per turn
Completed turns queue for BOS; conditional writes catch conflicts.
BOS first
Failed writes stay queued; no silent fallback to a truncated cache.
Configure, save, resume.
Configure storage
Set up BOS, then run celagent doctor and celagent cas-probe.
Wait for the write
Recovery needs a successful BOS write.
Resume by ID
celagent list, then celagent <id> on a configured machine.
Tasks recover from checkpoints.
celagent task submitcelagent task statuscelagent task ledger
Celld tasks have checkpoint recovery and an idempotent task ledger; see the repository for setup.
v0.4.3Aug 26, 2026Release notes ›
Get started
The installer fetches the GitHub Release binary with the celld runtime.
-
Install
curl -fsSL https://github.com/hxddh/celagent/releases/latest/download/install.sh | sh -
Check configuration, credentials, and BOS access
celagent doctor -
Start the TUI
celagent
FAQ
Does it sync my workspace?
No. 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.
What if a BOS write fails?
Retryable failures stay queued, and cross-machine recovery waits for a successful write. Recovery reads BOS first; only a missing object falls back to the worker cache. A BOS timeout or permission error does not fall back to truncated cache.
How is history stored?
sessions/<id>.jsonl stores Pi history, including tool calls and branches. Older JSON sessions use a legacy text recovery path.
How do I install it?
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.
celagent