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 request

Your 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.

Agent-native by construction

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/skills

Money safety

blockrun 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 totals

Payments 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.

Commands

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`

Sub-products (independently installable)

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 models

Missing 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.

How it relates to @blockrun/core

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.