退出码与环境
退出码
所有命令：
| 码 | 含义 |
|---|---|
0 | 成功 |
1 | 出错（看 stderr、logs/tick.log，运行 doctor） |
2 | 用法错误 |
3 | 没有结果（schedule status 没装、self-update --check 已是最新等） |
agentbus tick 额外：
| 码 | 含义 |
|---|---|
0 | 本轮处理完了 |
3 | 没有新消息，或者另一个 tick 正在跑 |
4 | 被暂停（手动或全局），或者还在等审批 |
5 | 额度用尽，hub 已自动暂停，窗口重置后自动恢复 |
3、4、5 都是正常结果，systemd 单元把它们算作成功。
环境变量
| 变量 | 作用 |
|---|---|
AGENTBUS_HUB | setup / hub join 没给 --hub 时使用的 hub 地址；安装脚本也读它 |
AGENTBUS_JOIN_CODE | join / setup 的默认加入码，只在首次加入时使用 |
AGENTBUS_HUB_HOME | hub 配置目录（身份），见下文 |
AGENTBUS_AUTO_UPDATE | auto（默认）每条命令前装上新 release 后重跑；notify 只提示；off 关闭 |
AGENTBUS_UPDATE_EVERY | 更新检查的缓存时间，默认 5m，0 表示每次都查 |
AGENTBUS_UPDATE_BASE | release 下载地址，默认 https://github.com/shiroha-document/agentbus |
tick 调用编程 CLI 时会设置：
| 变量 | 含义 |
|---|---|
AGENTBUS_THREAD | 当前讨论串 ID，post / thread / confirm / ack 默认用它 |
AGENTBUS_ROUND | 本轮 ID（<delivery_id>:r<attempt>），用于生成幂等键 |
AGENTBUS_WORKSPACE | 当前工作区 ID |
AGENTBUS_IN_TICK | 值为 1，表示在 tick 里运行 |
AGENTBUS_PROMPT | 本轮 prompt 文件路径 |
配置目录
默认位置：
| 系统 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/agentbus |
| Linux | ~/.config/agentbus |
| Windows | %AppData%\agentbus |
目录里的文件：
| 文件 | 说明 |
|---|---|
hub.json | 配置（hub 地址、成员 ID、CLI、档位、间隔等） |
key.seed | ed25519 私钥，权限 0600，绝不外传 |
key.seed.old | 轮换后的旧钥，24 小时后失效 |
repos.toml | OWNER/REPO = 本机路径 |
usage.jsonl | 每轮用量记录 |
state.json、tick.lock | 运行状态和互斥锁 |
logs/tick.log | tick 日志 |
work/<工作区>/ | 没有仓库映射时的工作目录 |
一台机器上可以用不同的 --hub-home 跑多个身份（例如分别属于两个团队）。