Skip to main content

​
Install with curl

curl -fsSL https://zerofinance.ai/install | bash
This installs Bun if needed, then installs agent-bank globally.

​
Install with Bun

bun add -g agent-bank
Verify the installation: 
zero --version
The CLI binary is zero (alias: zero-bank).

​
Run from the repo

The CLI lives in packages/cli and can be run directly from source: 
bun install
bun --cwd packages/cli run dev -- auth connect --no-browser
Use zero --debug auth whoami to print the resolved base URL.

​
Authenticate

​
Step 1: Get your API key

  1. Log in to 0.finance
  2. Go to Settings → API Keys
  3. Click Create API Key
  4. Copy the key (it starts with sk_live_ or sk_test_)
Store your API key securely. It provides full access to your workspace.

​
Step 2: Connect the CLI

Option A: Browser connect (recommended) 
zero auth connect
This opens a secure connection page on www.0.finance and stores the API key for you. If the automatic handoff fails, the page shows a copyable key for manual paste. Option B: API key 
zero auth login --api-key sk_live_your_api_key_here
This stores your credentials in ~/.zero-finance/config.json.

​
Step 3: Verify

zero auth whoami

{
  "workspace_id": "ws_xxx",
  "workspace_name": "My Company",
  "key_id": "key_xxx",
  "key_name": "Production Key",
  "align_customer_id": "align_xxx"
}

​
Configuration

The CLI stores configuration in ~/.zero-finance/config.json: 
{
  "apiKey": "sk_live_xxx",
  "baseUrl": "https://www.0.finance"
}

​
Custom base URL

For self-hosted deployments or local development: 
zero auth login --api-key sk_test_xxx --base-url http://localhost:3050
The base URL should be the root (e.g. https://www.0.finance), not .../api/cli. The CLI will normalize if you include /api/cli.

​
Log out

Remove stored credentials: 
zero auth logout

​
Next steps

CLI Reference

Complete command reference with examples.

Check balance

Your first CLI command.

CLI QA

Functionality coverage and smoke-test results.