Skip to content

The command line

The Katara CLI is a coding assistant that works in a git repository, plus a few account commands. It uses the same wallet and models as the chat app.

Terminal window
katara login

Opens the browser for sign-in and stores the session in your OS keychain.

Terminal window
katara balance # spendable, balance, approval, faucet state, and the next step
katara faucet # public test network: mint test USDC to your wallet
katara fund # print your address (and a QR code) for a transfer
katara budget # show the budget
katara budget follow # no cap: the approved amount follows the balance
katara budget set 20 # cap the approved amount at 20 USDC

Approving spending needs a passkey, so that step happens in the browser: katara balance tells you when it is needed.

Terminal window
cd your-repo
katara --model katara/llama-3.1-8b-instruct@1

After each reply the CLI prints the tokens used and the cost in USDC for the message and the session. Your repository is not uploaded; only the conversation is synced to your account.

When a request cannot be served, the CLI prints the reason and the command that fixes it, for example katara faucet when the balance is empty.