@runic-labs/cli

Inspecciona la caché y el libro mayor desde la línea de comandos.

npm install -g @runic-labs/cli

pnpm add -g @runic-labs/cli

npm install -g @runic-labs/cli

bun add -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.

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

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

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

Siguiente

• Libro mayor — lo que summary() realmente calcula internamente
• Benchmarks — reproduce tú mismo una ejecución completa de gasto/ahorro