Get Started

Credits

Check credit balance and start checkout from the CLI.

Credits are quota for operations that retrieve or process valuable agent context. The CLI exposes balance and checkout commands for the current personal or workspace context.

One credit is priced at $0.01. Checkout requires at least 500 credits total across allocations.

Check balance

epismo credit balance

The selected workspace determines which balance is returned. If no workspace is selected, the command uses personal space. When EPISMO_TOKEN is set, the token's embedded workspace determines the balance context.

The response includes:

Field Meaning
balance Available credits in the selected context
shortfall Amount currently missing for a credit requirement

Start checkout

epismo credit checkout --allocations '[{"userId":"<user-id>","quantity":500}]'

The command returns checkout information, including a URL. In a workspace context, allocations are associated with that workspace.

Each allocation requires a non-empty userId and positive integer quantity.

Avoid accidental credit usage

  • Agent usage, pack search, track search, and pack reads consume credits.
  • epismo pack search and epismo track search consume credits because they locate context for a user or agent.
  • epismo pack get consumes credits for outline, selected block/step, and full reads.
  • Use outline pack reads before --full when large packs are involved so later agent context stays smaller.
  • Use workspace-scoped CI tokens so credit usage is attributed to the intended workspace.
  • Check balance before jobs that run many searches/detail gets or hydrate large agent contexts.

Credit-gated operations can return 402 Payment Required when the selected context has insufficient balance. Post-read credit consumption is fail-open: if a credit-gated read succeeds but consumption fails, the response is still returned and the failure is logged server-side.