@runic-labs/cli

从命令行检查缓存和账本。

npm install -g @runic-labs/cli

pnpm add -g @runic-labs/cli

npm install -g @runic-labs/cli

bun add -g @runic-labs/cli

没有 runic invoke，也没有 runic install —— v1 不会执行或安装任何内容。CLI 只会读取你的代理进程已通过 @runic-labs/sdk 写入的同一份基于文件的状态。

runic cache status

列出缓存的签名、命中次数和最后使用时间。

$ runic cache status
a1b2c3d4e5f6  hits=3  tokensSpent=323  lastUsed=2026-08-21T22:40:11.203Z
9f8e7d6c5b4a  hits=0  tokensSpent=210  lastUsed=2026-08-21T22:39:58.771Z [stale]

如果尚未缓存任何内容，它会输出 No cached decisions yet.，而不是空表格。

runic ledger status

显示消耗与节省的 token 总数，以及按签名划分的命中明细。

$ runic ledger status
Total spent: 2582
Total saved: 12910
Cache hits:  40

Hits by signature:
  a1b2c3d4e5f6  5
  9f8e7d6c5b4a  3

指向特定代理的状态

CLI 默认从 @runic-labs/sdk 写入的同一位置读取 —— 当前工作目录中的 .runic/，或者已设置时的 $RUNIC_HOME。请从你的代理运行所在的同一目录执行它，或设置匹配的 RUNIC_HOME：

RUNIC_HOME=/var/lib/my-agent/runic runic ledger status

下一步

• 账本 —— summary() 在底层实际计算的内容
• 基准测试 —— 亲自复现一次完整的消耗/节省运行