CLI

npm install -g @ourseams/cli
seams auth login --token sk_acme_…

The four you will actually use

1. 1

   Mint a key

   Name the end user with your own id; mint creates them if they are new. The secret prints once. Use seams users create only when you want a balance without a key yet.

   cli

   seams keys mint --user alice --bundle pro --cap 50 --label "alice's laptop"
   
   # key          ak_acme_…
   # key prefix   ak_acme_simula
   # last four    9f2c
   # end user id  alice
   # warning      shown once; store it now

2. 2

   Find out why a call failed

   doctor walks the five misconfigurations behind most support requests and exits non-zero on an error, so it works as a CI gate.

   cli

   seams doctor --table
   
   # status  error
   #
   # LEVEL  CODE                  DETAIL                                   FIX
   # error  model_no_live_source  cheap has no enabled source              connect a provider account
   # warn   supply_unhealthy      anthropic has failed its last 4 probes   seams providers rotate anthropic --key <key>
   # warn   end_user_frozen       dara is frozen and cannot call           seams users unfreeze dara

3. 3

   Grant credit

   Takes dollars and converts; the ledger stores micro-dollars. One grant reaches one end user or fifty, and every balance moves or none does.

   cli

   seams users grant 25.00 --user alice --user bilal --reason top_up
   
   # recipients       2
   # amount each usd  25.00
   # total usd        50.00
   # reason           top_up
   # end users        alice, bilal

Everything else