aiblueprint-cli

AIBlueprint CLI

Supercharge Claude Code with security hooks, custom commands, intelligent statusline, and workflow automation.

📚 Full Documentation | 🎯 Premium Features

🚀 Quick Start

# Run setup (no installation required)
npx aiblueprint-cli@latest claude-code setup

✨ Features

• 🛡️ Security - Command validation hooks blocking dangerous operations
• 📊 Statusline - Git status, cost tracking, and token usage display
• 🤖 Commands - 16 pre-configured workflow automation commands
• 🎭 Agents - 3 specialized AI agents for codebase exploration
• ⚡ Scripts - Built-in utilities for spending reports and usage stats

📦 Installation

Option 1: Plugin (Recommended)

/plugin marketplace add melvynx/aiblueprint
/plugin install aibp-base@AIBlueprint

Option 2: CLI Tool

# Run without installation
npx aiblueprint-cli@latest claude-code setup

# Or install globally
npm install -g aiblueprint-cli

🎯 Usage

Setup

# Interactive setup
npx aiblueprint-cli@latest claude-code setup

# Install all features (no prompts)
npx aiblueprint-cli@latest claude-code setup --skip

# Custom location
npx aiblueprint-cli@latest claude-code setup --folder ~/.my-claude

Statusline Scripts

Run utility scripts from anywhere:

# List available scripts
npx aiblueprint-cli@latest claude-code statusline --list

# Today's spending report
npx aiblueprint-cli@latest claude-code statusline spend:today

# Weekly usage analysis
npx aiblueprint-cli@latest claude-code statusline weekly

# Configure statusline
npx aiblueprint-cli@latest claude-code statusline config

Available scripts:

• spend:today / spend:month / spend:project - Spending reports
• stats - Daily usage statistics
• weekly - Weekly usage analysis
• config - Interactive configuration
• migrate - Migrate to SQLite database

Other Commands

# Add specific hooks
npx aiblueprint-cli@latest claude-code add hook post-edit-typescript

# Manage commands
npx aiblueprint-cli@latest claude-code add commands
npx aiblueprint-cli@latest claude-code add commands commit

# Create symlinks between tools
npx aiblueprint-cli@latest claude-code symlink

📚 What You Get

Security Hooks

• Command validation - Blocks rm -rf, privilege escalation, remote execution
• TypeScript processing - Auto-format and lint after file edits
• Security logging - Tracks all blocked commands to ~/.claude/security.log

Custom Statusline

• Git branch, changes, and repository info
• Session costs and daily limits via ccusage
• Real-time token usage tracking
• Colored visual indicators

Commands (16 Available)

Development:

• commit - Fast conventional commits
• create-pull-request - Auto-generated PRs
• fix-pr-comments - Resolve PR comments
• run-tasks - Execute GitHub issues

Analysis:

• deep-code-analysis - Comprehensive codebase investigation
• explain-architecture - Pattern analysis with diagrams
• cleanup-context - Memory optimization

Utilities:

• claude-memory - CLAUDE.md management
• watch-ci - Automated CI monitoring
• epct - Explore-Plan-Code-Test methodology

Agents (3 Specialized)

• explore-codebase - Code discovery and analysis
• Snipper - Fast code modifications
• websearch - Quick web research

Shell Shortcuts

• cc - Claude Code with permissions skipped
• ccc - Claude Code with continue mode

Skills

Install individual skills directly into ~/.claude/skills/:

# Install a single skill
npx skills add Melvynx/aiblueprint --skill ultrathink

# Install multiple skills
npx skills add Melvynx/aiblueprint --skill claude-memory
npx skills add Melvynx/aiblueprint --skill fix-errors

Available skills:

Skill	Description
commit	Quick commit and push with clean messages
create-pr	Auto-generated pull requests
fix-pr-comments	Resolve PR review comments
merge	Context-aware branch merging
claude-memory	CLAUDE.md and .claude/rules management
prompt-creator	Expert prompt engineering
skill-creator	Guide for creating Claude Code skills
subagent-creator	Guide for building subagents
ralph-loop	Autonomous AI coding loop
fix-errors	Fix ESLint and TypeScript errors
fix-grammar	Fix grammar and spelling
oneshot	Ultra-fast feature implementation
ultrathink	Deep thinking mode for elegant solutions
apex-free	APEX methodology (Analyze-Plan-Execute-eXamine)

💎 Premium

Unlock advanced features at mlv.sh/claude-cli

# Activate premium
npx aiblueprint-cli@latest claude-code pro activate YOUR_TOKEN

# Setup premium configs
npx aiblueprint-cli@latest claude-code pro setup

🛠️ Development

# Clone and setup
git clone <repository>
cd aiblueprint-cli
bun install

# Development mode
bun run dev claude-code setup
bun run dev claude-code statusline --list

# Run tests
bun run test:run

# Build and test locally
bun run build
bun run test-local

📋 Requirements

• Node.js 16+ or Bun
• Claude Code installed
• Optional: bun, ccusage, gh CLI

🤝 Contributing

• Fork the repository
• Create a feature branch
• Make your changes
• Run tests: bun run test:run
• Submit a pull request

📄 License

MIT License - see LICENSE file for details.

Created by AIBlueprint - mlv.sh/claude-cli

Need help? Open an issue | Documentation