---
title: '@runic-labs/cli'
description: 从命令行检查缓存和账本。
sidebar:
  order: 6
---
```package-install
npm i -g @runic-labs/cli
```

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

## `runic cache status`

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

```bash
$ 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 总数，以及按签名划分的命中明细。

```bash
$ 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`：

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

## 下一步

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