AIBlueprint CLI
One command to set up Claude Code, Codex, and your whole AI coding workflow with sensible, battle-tested defaults.
AIBlueprint is a command-line tool that configures your AI coding environment in
seconds. It installs curated agents, skills, commands, a rich statusline, safety
hooks, and shell shortcuts into ~/.claude, ~/.codex, and a shared ~/.agents
folder, so every tool you use stays in sync.
npx aiblueprint-cli@latest agents setup
What you get
Start here
Core commands
agents setupInstall agents, skills, statusline, and shortcuts.
agents setup-terminalOh My Zsh, plugins, and a theme in one step.
agents symlinkShare config across Claude Code, Codex, and more.
agents unifyCentralize global or project agent config into .agents.
configsSave, load, and restore named configurations.
agents proActivate and install premium configurations.
Concepts
Main capabilities
- Unified config - Manage Claude Code, Codex, OpenCode, and FactoryAI from a single shared
~/.agentssource of truth. - Curated agents - Ship with
explore-codebase,explore-docs,websearch, andactionagents tuned for real work. - Productivity skills - 15+ skills including
commit,create-pr,prompt-creator,skill-manager,use-style, andultrathink. - Safety first - Command-validation hooks block destructive commands and protect secret files by default.
- Rich statusline - See git branch, token usage, and session cost without leaving your editor.
- Backups built in - Every change is snapshotted, so you can undo or restore any configuration at any time.
Requirements
| Requirement | Notes |
|---|---|
| Node.js 16+ | Required to run the CLI via npx. |
| Bun | Auto-installed when needed for the statusline. |
| ccusage | Auto-installed for token and cost tracking. |
| macOS / Linux | Full support. Windows has limited support (WSL recommended). |