@runic-labs/cli

Inspecione o cache e o ledger pela linha de comando.

npm install -g @runic-labs/cli

pnpm add -g @runic-labs/cli

npm install -g @runic-labs/cli

bun add -g @runic-labs/cli

Não há runic invoke, nem runic install — a v1 não executa nem instala nada. A CLI apenas lê o mesmo estado armazenado em arquivos que o processo do seu agente já grava por meio de @runic-labs/sdk.

runic cache status

Lista assinaturas em cache, contagens de acertos e horários do ú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]

Se ainda não houver nada em cache, imprime No cached decisions yet. em vez de uma tabela vazia.

runic ledger status

Mostra o total de tokens gastos em comparação aos economizados, além de um detalhamento de acertos por assinatura.

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

Hits by signature:
  a1b2c3d4e5f6  5
  9f8e7d6c5b4a  3

Apontando para o estado de um agente específico

A CLI lê do mesmo local em que @runic-labs/sdk grava por padrão — .runic/ no diretório de trabalho atual, ou $RUNIC_HOME se estiver definido. Execute-a no mesmo diretório em que seu agente é executado ou defina RUNIC_HOME para corresponder:

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

Próximos passos

• Ledger — o que summary() realmente calcula internamente
• Benchmarks — reproduza você mesmo uma execução completa de gastos/economia