---
title: '@runic-labs/cli'
description: Inspecciona la caché y el libro mayor desde la línea de comandos.
sidebar:
  order: 6
---
```package-install
npm i -g @runic-labs/cli
```

No existe `runic invoke` ni `runic install`: v1 no ejecuta ni instala nada. La CLI solo lee el mismo estado respaldado por archivos que tu proceso de agente ya escribe mediante `@runic-labs/sdk`.

## `runic cache status`

Enumera las firmas almacenadas en caché, los recuentos de aciertos y las horas del último uso.

```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 aún no se ha almacenado nada en caché, muestra `No cached decisions yet.` en lugar de una tabla vacía.

## `runic ledger status`

Muestra el total de tokens gastados frente a los ahorrados, además de un desglose de aciertos por firma.

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

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

## Apuntar al estado de un agente específico

La CLI lee desde la misma ubicación en la que `@runic-labs/sdk` escribe de forma predeterminada: `.runic/` en el directorio de trabajo actual, o `$RUNIC_HOME` si está configurado. Ejecútala desde el mismo directorio desde el que se ejecuta tu agente, o establece `RUNIC_HOME` para que coincida:

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

## Siguiente

- [Libro mayor](/ledger) — lo que `summary()` realmente calcula internamente
- [Benchmarks](/benchmarks) — reproduce tú mismo una ejecución completa de gasto/ahorro