---
title: '@runic-labs/cli'
description: Inspectez le cache et le registre depuis la ligne de commande.
sidebar:
  order: 6
---
```package-install
npm i -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.

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

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.

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

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

## Suite

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