AIBlueprint CLI
DocsGitHubnpm
Browse documentation

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, a rich statusline, safety hooks, and shell shortcuts into ~/.claude, ~/.codex, and a shared ~/.agents folder, so every tool you use stays in sync.

Terminal
npx aiblueprint-cli@latest agents setup

What you get

Start here

InstallationInstall the CLI and run your first setup.
Quick StartConfigure everything with a single command.
SecuritySafety hooks and permission defaults applied for you.

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.

Skills

All skillsFree catalog plus every Premium skill, with a PRO badge in the sidebar.
Use StyleNamed visual styles for UI implementation.
Use ArtifactsPROPolished local HTML for plans, options, and prototypes.
ExamplesPreview every bundled style with a picker.

Concepts

StatuslineGit, tokens, and cost info in your prompt.
AgentsSpecialized agents for exploration and research.
Effort levelRoute Low to Max by task difficulty. Max is not a default.
Don't overflow memoryKeep AGENTS.md short. Dead Markdown pollutes the agent more than it helps.
Context sweet spotStay under the attention cliff. A 1M window is slower, dumber, and more expensive.
Landing Page ReferencesBrowse screenshot options for mobile app landing pages.

Main capabilities

  • Unified config - Manage Claude Code, Codex, OpenCode, and FactoryAI from a single shared ~/.agents source of truth.
  • Curated agents - Ship with explore-codebase, explore-docs, websearch, and action agents tuned for real work.
  • Productivity skills - Curated skills including apex, skill-manager, use-style, and grill-me.
  • 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 - Setup and sync back up existing configuration; named snapshots and restore commands help recover it.

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).
Next Installation