---
title: '@runic-labs/cli'
description: Untersuche den Cache und das Ledger über die Befehlszeile.
sidebar:
  order: 6
---
```package-install
npm i -g @runic-labs/cli
```

Es gibt kein `runic invoke` und kein `runic install` — v1 führt nichts aus und installiert nichts. Die CLI liest nur denselben dateibasierten Zustand, den dein Agentenprozess bereits über `@runic-labs/sdk` schreibt.

## `runic cache status`

Listet zwischengespeicherte Signaturen, Trefferzahlen und Zeitpunkte der letzten Nutzung auf.

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

Wenn noch nichts zwischengespeichert wurde, wird statt einer leeren Tabelle `No cached decisions yet.` ausgegeben.

## `runic ledger status`

Zeigt die insgesamt ausgegebenen gegenüber den eingesparten Tokens sowie eine Aufschlüsselung der Treffer pro Signatur.

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

Hits by signature:
  a1b2c3d4e5f6  5
  9f8e7d6c5b4a  3
```

## Auf den Zustand eines bestimmten Agenten verweisen

Die CLI liest standardmäßig aus demselben Speicherort, in den `@runic-labs/sdk` schreibt — `.runic/` im aktuellen Arbeitsverzeichnis oder `$RUNIC_HOME`, falls gesetzt. Führe sie aus demselben Verzeichnis aus, aus dem dein Agent läuft, oder setze `RUNIC_HOME` entsprechend:

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

## Weiter

- [Ledger](/ledger) — was `summary()` tatsächlich im Hintergrund berechnet
- [Benchmarks](/benchmarks) — führe selbst einen vollständigen Ausgaben-/Einsparungslauf durch