@tokium-labs/cli

CLI for Tokium — manage accounts, agents, and wallets from the terminal.

The SDK (@tokium-labs/sdk) is for building apps. The MCP server is for AI agents. The CLI is for humans — a fast way to manage your Tokium account without leaving the terminal.

Install

npm install -g @tokium-labs/cli

Or run directly with npx:

npx @tokium-labs/cli status

Quick Start

# Create an account
tokium register

# Or login to an existing one
tokium login

# See your account and agents
tokium status

# Create an agent and get its API key
tokium agents create my-agent

# Fund it
tokium top-up 42 10

# Check the balance
tokium balance 42

# Browse APIs
tokium proxies list
tokium proxies search "web scraping"

# Call a proxy
tokium proxies call 7 --path /search --method POST --body '{"q":"test"}'

# Logout
tokium logout

Commands

Authentication

| Command | Description | |---------|-------------| | tokium register | Create a new account (prompts for email + password) | | tokium login | Login to your account | | tokium logout | Clear stored credentials | | tokium status | Show account info and agents overview |

Agents

| Command | Description | |---------|-------------| | tokium agents list | List all agents with balances and limits | | tokium agents create <name> | Create a new agent (prints API key once) | | tokium agents delete <id> | Delete an agent (with confirmation) |

agents create options:

-d, --daily-limit <amount>    Daily spend limit in USD
-m, --monthly-limit <amount>  Monthly spend limit in USD
-r, --rate-limit <rph>        Rate limit (requests per hour)

Wallet

| Command | Description | |---------|-------------| | tokium balance [agentId] | Show balance and recent transactions | | tokium top-up <agentId> <amount> | Generate a Stripe checkout link to fund an agent |

Proxies

| Command | Description | |---------|-------------| | tokium proxies list | List available API proxies | | tokium proxies search <query> | Search proxies by keyword | | tokium proxies call <proxyId> | Call a proxy endpoint |

proxies list options:

-c, --category <category>  Filter by category

proxies call options:

-p, --path <path>          Endpoint path (required)
-m, --method <method>      HTTP method (default: GET)
-b, --body <json>          Request body (JSON string)
-H, --header <header...>   Headers (key:value)
-q, --query <query...>     Query params (key=value)

Config

Credentials are stored in ~/.tokium/config.json with restricted file permissions (0600). The file is created on login/register and removed on logout.

{
  "token": "eyJ...",
  "email": "[email protected]"
}

License

MIT