---
title: '@runic-labs/cli'
description: Inspecione o cache e o ledger pela linha de comando.
sidebar:
  order: 6
---
```package-install
npm i -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.

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

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.

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

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

## Próximos passos

- [Ledger](/ledger) — o que `summary()` realmente calcula internamente
- [Benchmarks](/benchmarks) — reproduza você mesmo uma execução completa de gastos/economia