安装并启动 TUI
从最新 Release 用 install.sh 安装（Windows 用 install.ps1），再运行 `celagent` 打开带持久化 ID 的 Pi 会话。
celagent · Pi TUI · BOS 会话权威
Pi TUI，会话落在对象存储
完整 Pi Coding Agent TUI，会话权威落在 BOS。CAS 写入可跨机恢复历史；任务 ledger 覆盖分布式工作。
$ celagent
命令
-
celagent -
celagent list -
celagent <id> # 从 BOS 恢复 -
celagent task ledger
持久化 权威：BOS · 缓存：worker SQLite · 恢复：先读 BOS · RPO≈0
Pi TUI · Celld/BOSCAS If-Match · 跨机恢复
Pi TUI + BOS 持久化
会话权威落在对象存储
celagent 运行完整 Pi Coding Agent TUI。每轮双写本地 worker 缓存与带 CAS 的 BOS；恢复先读 BOS，换机器也能找回会话。
持久化模型
BOS 是权威，worker 是缓存
每轮双写本地 worker SQLite 缓存与带 CAS 乐观锁的 BOS。恢复先读 BOS；worker 仅作 miss 回退（RPO≈0）。
- 01
Pi TUI 回合
pi-coding-agent 引擎负责交互、工具与模型。turn_end 钩子在不阻塞对话的情况下持久化。
- 02
Worker 缓存
本地 SQLite 做快速缓存，写入预算很短。缓存丢失可从 BOS 重建。
- 03
BOS CAS 写入
直写 BOS 使用 If-Match 乐观锁、幂等去重与异步队列。sessions/<id>.json 保留完整轮次。
- 04
跨机恢复
`celagent <id>` 从 BOS 加载历史。`list`、`doctor`、`cas-probe` 检查可恢复性与条件写就绪。
一次会话怎么跑
一次会话怎么跑
每轮写入 BOS
回合结束时 worker 本地缓存，同时 CAS 乐观锁直写 BOS。BOS 是会话权威（RPO≈0）；worker 仅作 miss 回退。
换机器恢复
`celagent <id>` 优先从 BOS 读完整历史。`celagent list` 列出可恢复会话；需要时可导出或删除。
提交分布式任务
`celagent task submit/status/ledger` 驱动 Celld 状态机，支持断点续跑与单 cell 幂等 ledger。
覆盖范围
需要对象存储持久会话与任务状态的场景
跨机会话恢复BOS 保存对话历史CAS 冲突检测分布式任务提交 / 状态幂等任务 ledgerdoctor 与 cas-probe 自检
当 Pi TUI 会话必须在换机、本地缓存丢失或多步 Celld 任务后仍可恢复时，使用 celagent。
常见问题与用法
怎么安装？
Unix：`curl -fsSL https://github.com/hxddh/celagent/releases/latest/download/install.sh | sh`。Windows：从同一 Release 运行 install.ps1（仅 CLI；上游 Celld 无 Windows 包）。
会话权威在哪里？
在 BOS。每轮双写 worker 缓存与带 CAS 的 BOS。恢复先读 BOS；worker 只在 miss 时回退。
会 fork Pi 吗？
不会。复用 pi-coding-agent 引擎，保留 bash、read、write、grep、find、edit、ls 等全量工具与多模型切换。
使用什么许可？
MIT。