0 rrery
AI代理工作流的跟踪优先、本地优先的可观察性。观察您的Claude Code会话实际做了什么（每个工具调用、子代理、LLM调用和权限决定），作为本地仪表板中的实时跟踪。一个进程，一个SQLite文件，没有云。摄取Claude Code和OpenAI Codex CLI会话。
快速入门
npm install -g 0rrery # or: bun install -g 0rrery
0rrery init
init 做三件事（每个都可以跳过）：安装Claude Code钩子(--no-hooks)，设置一个用户服务，以便持久化运行(--no-service)，并导入现有的会话历史记录(--no-import）. 然后打开 http://localhost:7317.
需要 包子 运行时≥1.1：即使通过npm安装，CLI也运行在Bun上，因此 npm install 成功无Bun，但the 0rrery 命令退出，并显示一条install-Bun消息，直到Bun位于您的PATH上。Claude Code钩子需要全局安装(hook命令是 0rrery hook); bunx 0rrery serve 无需安装即可环顾四周。
命令
| 命令 | 它是做什么的 |
|---|---|
0rrery init | 钩子+座席技能+服务+历史导入，幂等 |
0rrery serve | 在前台运行服务器+仪表板 |
0rrery install | （重新）安装Claude Code钩子到 ~/.claude/settings.json;替换过时的ery条目 |
0rrery import <file.jsonl> | 导入一份成绩单 |
0rrery import --all | 导入下面的所有内容 ~/.claude/projects |
0rrery service install|uninstall|status | 管理systemd用户单元(Linux) /启动代理（macOS） |
写在哪里
~/.claude/settings.json- hook entries（命令）0rrery hook）~/.0rrery/- SQLite DB + tailer偏移量~/.config/systemd/user/0rrery.service或者~/Library/LaunchAgents/com.0pon.0rrery.plist
配置
| Env var | 默认的 | |
|---|---|---|
ORRERY_PORT | 7317 | 仪表板/ API端口 |
ORRERY_HOST | 127.0.0.1 | 绑定地址（仅限本地主机） |
ORRERY_DATA_DIR | ~/.0rrery | 数据目录 |
ORRERY_DB | <data dir>/0rrery.db | 数据库路径 |
ORRERY_URL | http://localhost:7317 | 钩子/导入到哪里 |
ORRERY_CLAUDE_DIR | ~/.claude | Claude Code config/transcripts root |
代理技术
init 在 ~/.claude/skills/0rrery/ 它教会Claude通过查询本地API来回答诸如“我这周花了多少钱”、“这个回购中什么总是失败”或“我上一个会话做了什么”之类的问题。跳过, --no-skill;删除与 rm -rf ~/.claude/skills/0rrery.
释放
版本由CI通过npm可信发布（Trusted Publishing）发布：插入版本 scripts/build-pkg.ts、标记 vX.Y.Z，推标签-工作流测试、阶段和发布带有出处。没有令牌。
升级
npm install -g 0rrery@latest # or: bun install -g 0rrery@latest
0rrery service uninstall && 0rrery service install # regenerate if the bin path changed
升级后（或者从repo开发时），重新构建并强制重新安装，这样仪表板就会选择新的bundle： bun run build:pkg,然后 bun install -g 0rrery@latest 对于注册表安装，或 cd ~ && bun install --force 用于 file:-pinned dev安装-一个不变的 file: 否则，Dep可能会跳过重新复制。
卸载
0rrery service uninstall
npm uninstall -g 0rrery # or: bun remove -g 0rrery
rm -rf ~/.0rrery
钩子项：重新运行Claude会话或删除命令为 0rrery hook 从 ~/.claude/settings.json.
开发
bun install
bun run build # dashboard
bun test
bun packages/cli/src/index.ts serve
bun run build:pkg # stage the npm package in dist-pkg/
规范生活在 docs/superpowers/specs/.
想让ery摄取另一个代理CLI？看到 ADAPTERS.md.