@bankr/cli
Official CLI for the Bankr AI agent platform. Prompt the Bankr agent, manage your wallet, launch tokens and claim their fees, and use the Bankr LLM gateway from your terminal.
The full command reference is at docs.bankr.bot/cli, what changed in each version is at docs.bankr.bot/cli-changelog, and every command takes --help.
Installation
npm install -g @bankr/cli # or: bun install -g @bankr/cli
# Later: update with whichever package manager installed it
bankr update
Log in
# Interactive: sign in with email, open bankr.bot to create a key, or paste one
bankr login
# Headless email login, for scripts and agents
bankr login email [email protected] # step 1: send a one-time code
bankr login email [email protected] --code 123456 # step 2: verify and create an API key (new accounts get a wallet)
# An existing bk_... key from bankr.bot/api-keys (checked against the API before it's saved)
bankr login --api-key bk_YOUR_KEY
# Sign-In with Ethereum, for headless agents
bankr login siwe --private-key 0xYOUR_PRIVATE_KEY
# Show the key in use, check the connection, and list your account details
bankr whoami
- Completing a headless email login (
--codeor--ni) or a SIWE login accepts the Terms of Service. - Email-login keys get Wallet, Agent and Token Launch API access and can transact. Opt out with
--no-wallet-api,--no-agent-api,--no-token-launchor--read-only, and add LLM gateway access with--llm. SIWE keys are read-only unless you pass--read-write. - On an account with MFA, email login prints a bankr.bot approval link (valid for five minutes) and continues once you approve it with your passkey or authenticator app. With an authenticator app, an interactive login also takes the 6-digit code right in the terminal.
Prompt the agent
Prompting the agent from the CLI needs a Bankr Club membership or LLM credits for Max Mode — see Access.
bankr "what is the price of ETH?" # shorthand for bankr agent
bankr agent "swap 10 USDC to ETH on base"
bankr agent --continue "and what about SOL?" # continue the last thread (-c)
bankr agent --thread thr_ABC123 "tell me more"
bankr agent --model claude-opus-5 "audit this contract" # Max Mode, billed to LLM credits
echo 'buy $50 of ETH on base' | bankr agent prompt # piped prompt; single quotes keep $50 intact
bankr agent status job_ABC123DEF456 --wait # follow a job until it finishes
bankr agent cancel job_ABC123DEF456
The agent's progress lines print on stderr while it works, so they stay out of piped output.
Commands
| Command | What it does |
|---|---|
bankr wallet | Portfolio, transfer, swap, sign and submit, without the agent |
bankr tokens | Token search and info |
bankr launch | Launch a token on Base, Robinhood Chain or Arbitrum; bankr launch quotes lists the tokens a launch can pair with |
bankr fees | Creator-fee dashboard and claims, including fees claim-wallet with your own private key |
bankr llm, bankr claude (bankr cc) | LLM gateway: models, usage, credits and auto top-up, coding-tool config, and Claude Code or OpenCode via the gateway. |
bankr project | Your project page |
bankr club | Bankr Club status, sign-up and cancellation |
bankr files | Your wallet's file storage |
bankr x402, bankr webhooks | Deploy and manage paid x402 endpoints and webhooks that trigger the agent |
bankr config, bankr sounds, bankr update, bankr logout | Settings and maintenance |
Add --ni (or set BANKR_NOT_INTERACTIVE=1) to any command to skip confirmations and fail fast instead of prompting.
The package also exports its API client (submitPrompt, pollJob, getUserInfo, getBalances and more) for Node.js — see Programmatic usage.
Configuration
Credentials are stored in ~/.bankr/config.json; use --config <path> or BANKR_CONFIG for another file. Environment variables override stored values:
| Variable | Description |
|---|---|
BANKR_API_KEY | API key |
BANKR_LLM_KEY | LLM gateway key (falls back to the API key if not set) |
BANKR_API_URL | API URL (default: https://api.bankr.bot) |
BANKR_LLM_URL | LLM gateway URL (default: https://llm.bankr.bot) |
Read and set stored values with bankr config get|set apiKey|apiUrl|llmKey|llmUrl.
License
MIT