CLI

The koda CLI is a thin client over the same gateway API (built on @koda-rising/sdk). It stores credentials in ~/.koda/config.json and works offline with an exactly-once queue.

Auth & account

koda login --url <gateway-url> --token <org-token>   # save credentials
koda use <org-id>                                     # set the active org (sent with each request)
koda wallet                                           # balance + recent ledger

Fund the wallet

koda topup <amount> [--channel card|ussd|opay|palmpay|mpesa|mtn_momo|ozow|fawry] [--email <e>] [--phone <2547...>]
koda verify <reference>                               # confirm a top-up and credit the wallet

Mobile-money channels (mpesa, mtn_momo, …) require --phone.

Run tasks

koda run "<task>" [--file <path>] [--apply] [--low-bandwidth] [--queue]
koda run "<task>" --loop [--test "<cmd>"] [--sandbox local|docker] [--max-iters <n>] [--apply]

• --file adds a file as context · --apply writes the returned edits · --low-bandwidth pins the open lane.
• --loop runs the plan→edit→verify loop; --sandbox docker --test "npm test" runs your tests each iteration.

Offline queue

koda queue        # list tasks waiting to sync (auto-queued on network error, or with --queue)
koda sync         # run all queued tasks — exactly-once, safe to retry (never double-charges)

Repo index (retrieval)

koda repo index <file...>     # embed files for retrieval (vector mode)
koda repo status              # { enabled, chunks, paths }
koda repo clear [path]        # clear the index, or one path

API keys & teams

koda keys create [name] [--scopes a,b]   # issue a scoped key (shown once)
koda keys list | koda keys revoke <id>

koda team create <name>
koda team invite <org-id> <email> [--role admin|member] [--cap <naira>]
koda team members <org-id>               # roster + month-to-date spend

Run koda help for the full list. For programmatic use, see the SDK guide.