@runic-labs/cli

Inspectez le cache et le registre depuis la ligne de commande.

npm install -g @runic-labs/cli

pnpm add -g @runic-labs/cli

npm install -g @runic-labs/cli

bun add -g @runic-labs/cli

Il n’existe pas de runic invoke ni de runic install — la v1 n’exécute ni n’installe quoi que ce soit. La CLI lit uniquement le même état stocké dans des fichiers que votre processus d’agent écrit déjà via @runic-labs/sdk.

runic cache status

Liste les signatures mises en cache, le nombre d’accès et les heures de dernière utilisation.

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

Si rien n’a encore été mis en cache, la commande affiche No cached decisions yet. au lieu d’un tableau vide.

runic ledger status

Affiche le total de tokens dépensés par rapport à ceux économisés, ainsi qu’une répartition des accès par signature.

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

Hits by signature:
  a1b2c3d4e5f6  5
  9f8e7d6c5b4a  3

Pointer vers l’état d’un agent spécifique

La CLI lit au même emplacement où @runic-labs/sdk écrit par défaut — .runic/ dans le répertoire de travail actuel, ou $RUNIC_HOME s’il est défini. Exécutez-la depuis le même répertoire que votre agent, ou définissez RUNIC_HOME en conséquence :

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

Suite

• Registre — ce que summary() calcule réellement en interne
• Benchmarks — reproduisez vous-même une exécution complète avec dépenses/économies