CLI Reference

Commands

17 CLI commands across Workflow, Setup, Chat, Reputation, Alerts, Tasks (local only) — grounded in verified addresses on Base 8453 and Robinhood Chain 4663. Install with npm i -g @blueagent/cli.

5 core commands

blue idea
Fundable brief
$0.05
blue build
Full architecture
$0.50
blue audit
Security review
$1.00
blue ship
Deploy checklist
$0.10
blue raise
Pitch narrative
$0.20

Workflow

blue idea [prompt]

Concept → fundable brief (problem, why Base, MVP, risks, 24h plan)

eg:blue idea "NFT marketplace for Base agents"
blue build [prompt]

Brief → architecture + stack, folder structure, integrations

eg:blue build "Base-native staking protocol"
blue audit [prompt]

Code → security review (reentrancy, oracle, MEV, go/no-go)

eg:blue audit "my Solidity contract"
blue ship [prompt]

Project → deploy checklist, verification, release notes, monitoring

eg:blue ship "launch on Base mainnet"
blue raise [prompt]

Idea → fundraising narrative, investor map, competitive landscape

eg:blue raise "Base DeFi protocol"

Setup

blue init

Install skill files to ~/.blue-agent/skills/ for local grounding

eg:blue init
blue new <name>

Scaffold a new Base project — base-agent | base-x402 | base-token

eg:blue new my-token --template base-token
blue doctor

Check environment health — Node, skills, API key, config

eg:blue doctor
blue validate [dir]

Validate project structure — package.json, tsconfig, env, src/, git

eg:blue validate ./my-project

Chat

blue chat [prompt]

Interactive chat with the Blue Agent LLM (Virtuals) in the terminal

eg:blue chat "how do I add x402 to my API?"

Reputation

blue score [handle]

Builder Score for a wallet or X handle

eg:blue score @blueagent_
blue compare [a] [b]

Compare two builders or agents side by side

eg:blue compare @a @b

Alerts

blue alert [subcommand]

Record a threshold alert locally — nothing delivers until you wire a listener

eg:blue alert add

Tasks (local only)

blue tasks

List tasks from ~/.blue-agent/tasks.json on this machine — not a shared board

eg:blue tasks
blue post-task [handle]

Write a task to that local file. Records a budget figure; moves no USDC

eg:blue post-task @myhandle
blue accept [taskId] [handle]

Mark a local task accepted

eg:blue accept task_abc123 @me
blue submit [taskId] [h] [proof]

Attach proof and record the reward as owed — nothing pays out until you settle it yourself

eg:blue submit task_abc123 @me https://github.com/…

All 5 run in the CLI, and each is a paid x402 tool. In your IDE the MCP server loads blue_build and blue_audit; idea, ship and raise ship as Claude Skills in the blue-agent plugin instead, so they cost no context until you use one. Blue Chat has no slash command for them — it keeps only /credits and /help.