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

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

```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](/ledger) — `summary()` が内部で実際に計算している内容
- [Benchmarks](/benchmarks) — 使用量／節約量の完全な実行を自分で再現する