Authentication
Sign in to Kolbo Code with your Kolbo.AI account via device-code OAuth
Kolbo Code uses device-code OAuth to link the CLI to your Kolbo.AI account. You never paste an API key — the CLI opens a browser page where you approve the device, and the resulting token is stored locally.
Login
kolbo auth loginWhen prompted, pick "Login with Kolbo". The CLI will:
- Call the Kolbo device-code endpoint to get a short user code.
- Open app.kolbo.ai/device in your browser.
- Ask you to enter the code and approve the device.
- Exchange the approved device code for a long-lived API key.
All inference you run from the CLI after this point is billed against your Kolbo.AI credit balance, just like image / video / music generation in the web app.
Check the active account
kolbo auth listLog out
kolbo auth logoutThis removes the stored token from ~/.local/share/kolbo/auth.json (Linux /
macOS) or %LOCALAPPDATA%\kolbo\auth.json (Windows). You can re-run
kolbo auth login at any time to sign back in.
Where the token is stored
| Platform | Path |
|---|---|
| macOS | ~/Library/Application Support/kolbo/auth.json |
| Linux | ~/.local/share/kolbo/auth.json |
| Windows | %LOCALAPPDATA%\kolbo\auth.json |
The file is mode 0600 and contains the OAuth refresh token used to
authenticate every subsequent request to api.kolbo.ai.
Managed inference
All chat / coding model calls route through kolbo-api at
https://api.kolbo.ai. You do not need to configure any provider keys
(OpenAI, Anthropic, Google) separately — Kolbo handles all upstream
providers on the server side and bills your account in Kolbo credits.