@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`

使用トークン数と節約トークン数の合計、およびシグネチャごとのヒット内訳を表示します。

$ 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

Ledger — summary() が内部で実際に計算している内容
Benchmarks — 使用量／節約量の完全な実行を自分で再現する

@runic-labs/cli

runic cache status

runic ledger status

特定のエージェントの状態を指定する

次へ

`runic cache status`

`runic ledger status`