One entry point for every BlockRun product. Pay-per-request AI — chat, image, video, music, speech — plus live data (web/X search, prediction markets, Pyth prices, 40+ chain RPC) and any x402-paid endpoint, all billed from a local USDC wallet. No API keys. No accounts. No subscriptions.
npm install -g @blockrun/cli
blockrun status # wallet auto-detected (or: blockrun wallet create)
blockrun fund # send USDC on Base to the printed address
blockrun run nvidia/deepseek-v4-flash "hello" # free model — $0
blockrun run openai/gpt-5.2 "hello" # paid per requestYour wallet lives at ~/.blockrun/.session and is shared with every BlockRun tool (ClawRouter, Franklin, BlockRun MCP, clawrouter-codex). The private key never leaves your machine — it signs x402 micropayments locally.
Every command speaks one machine-readable contract:
$ blockrun --json balance
{"ok":true,"data":{"address":"0x3491…402E","balance":"$21.44","chain":"base"}}
$ blockrun --json run bad/model "hi"
{"ok":false,"error":{"type":"run","message":"…"}} # stderr, exit 1--format json|pretty|table|ndjson|csv on everything. Teach your agent the whole CLI in one step:
blockrun skills add # installs the bundled skill into ~/.claude/skillsblockrun api POST v1/chat/completions --data '{…}' --quote # price WITHOUT paying
blockrun limits set --per-call 0.5 --daily 20 --monthly 200 # hard ceilings
blockrun limits deny video # category blacklist
blockrun spend today # real ledger totalsPayments above the per-call cap (default $1) are refused unless you explicitly raise it with --max. Daily/monthly ceilings are enforced against the real cost ledger before any paid command runs.
| Group | Commands |
|---|---|
| Wallet | status wallet create wallet import --stdin wallet export/recover balance fund chain config doctor |
| Inference | run <model> "<prompt>" chat (REPL) models [--free] |
| Multimodal | image (+edit) video music speech (+voices) realface enroll — URLs by default, --out saves |
| Data | search research predict crypto price rpc discover |
| x402 | api <METHOD> <url|path> pay <url> — any paid endpoint, --quote to price |
| Guardrails | limits policy spend |
| Ecosystem | ext list/install/remove skills list/add upgrade |
blockrun route serve # → ClawRouter: smart LLM routing, save up to 92%
blockrun agent start # → Franklin: the autonomous agent with a wallet
blockrun mcp add # → BlockRun MCP for Claude
blockrun codex up # → run OpenAI Codex on BlockRun modelsMissing one? blockrun ext install route. Any blockrun-<x> executable on your PATH automatically becomes blockrun <x> (the gh/Docker extension model) — existing commands like clawrouter and franklin keep working unchanged.
The CLI is a thin shell over @blockrun/core — the shared kernel (wallet resolution, x402 payment, output contract) that every BlockRun product depends on. One wallet, one payment path, one contract.
MIT — source at BlockRunAI/blockrun-cli.