CLI Reference

Blue CLI

The @blueagent/cli package ships two binaries: blue for direct commands and blueagent for an interactive TUI. Requires Node.js ≥ 18. Published on npm.

Install

@blueagent/clinpm

$ npm install -g @blueagent/cli

# verify
$ blue doctor

Two ways to run

blue — direct commands

One-shot commands for scripts and CI: blue idea "…", blue audit "…". See Commands.

blueagent — interactive TUI

A full-screen menu — arrow keys to browse and run every command without memorizing flags.

No install? Use the browser terminal

blueagent.dev/terminal runs the same commands in your browser — tab-autocomplete and full history, nothing to install.

First-run setup

setup

# install skill files (grounding knowledge) to ~/.blue-agent/skills/
$ blue init

# scaffold a new Base project
$ blue new my-app --template base-token   # base-agent | base-x402 | base-token

# health-check an existing project
$ blue validate ./my-project

Configuration

Configure the CLI with environment variables:

BANKR_API_KEY

Bankr LLM key — required for AI-backed commands (idea/build/audit/ship/raise). Core scaffolding works without it.

BLUE_AGENT_SKILLS_DIR

Override the skills directory. Takes priority over ~/.blue-agent/skills/ and the bundled skills.

Skill load order

BLUE_AGENT_SKILLS_DIR → ~/.blue-agent/skills/ → bundled skills. See Skills.

← Previous

BlueBank

Commands