NeuralQuantum.ai Agent-Powered CLI - A command-line tool that wraps Claude Code with 68+ specialized AI agents for automated development workflows.

⚠️ Internal Version: This build includes an embedded OAuth token for internal VibeCaaS/NeuralQuantum.ai team use only. Do not distribute publicly.

Features

• Auto-Orchestration: Automatically analyzes, enhances, and routes your requests to the right agents
• Chain-of-Verification (CoV): High-accuracy, bias-resistant verification workflow for critical decisions
• 68+ Specialized Agents: AI, Quantum, iOS, Web, DevOps, Security, and more
• Metacognition Layer: Self-aware reasoning with critique, regulation, and learning
• Fast Dispatch: Quick routing for simple tasks
• Project Integration: Initialize any project with full agent support

Prerequisites

• Claude Code - Install from claude.ai/code

  npm install -g @anthropic-ai/claude-code
  claude auth login

• macOS, Linux, or WSL (Windows Subsystem for Linux)

Installation

npm (Recommended)

The easiest way to install Craig-O-Code:

npm install -g craig-o-code

That's it! The package will:

• Install the coc, craig, and craig-o-code CLI commands globally
• Set up 68+ agents in ~/.cursor/agents/
• Create global cursor rules

Verify installation:

coc version
coc list

From Source

# Clone the repository
git clone https://github.com/ttracx/craig-o-code.git
cd craig-o-code

# Run installer
chmod +x scripts/install.sh
./scripts/install.sh

# Reload your shell
source ~/.zshrc  # or ~/.bashrc

Quick Install (One-liner)

curl -fsSL https://raw.githubusercontent.com/ttracx/craig-o-code/main/scripts/install.sh | bash

Update Agents Only

If you've already installed via npm and want to update agents:

npm run install-agents

Usage

Auto-Orchestration (Recommended)

Just describe what you want - Craig-O-Code figures out the rest:

coc go "add user authentication with JWT"
coc go "build a REST API for products"
coc go "fix the memory leak in the worker"

Quick Dispatch

For simple, single-domain tasks:

coc quick "add a loading spinner"
coc quick "fix the button hover state"

Chain-of-Verification (High Accuracy)

For critical decisions requiring verified, bias-resistant answers:

coc verify "What's the best approach for database migrations?"
coc deepverify "Should we use microservices or monolith?"
coc quickverify "Is Redis good for session storage?"

Direct Agent Access

When you know exactly which specialist you need:

coc agent swiftui-architect "design a settings view"
coc agent quantum-ml-researcher "implement VQE algorithm"
coc agent rag-specialist "design hybrid search"

The craig Shortcut

Even faster - just use craig:

craig "add dark mode support"
craig "optimize database queries"
craig "build a dashboard component"

Commands Reference

Auto-Orchestration

| Command | Description | |---------|-------------| | coc go <prompt> | Full auto-orchestration pipeline | | coc do <prompt> | Alias for go | | coc quick <prompt> | Fast routing for simple tasks | | craig <prompt> | Shortcut for coc go |

Agent Commands

| Command | Description | |---------|-------------| | coc agent <name> <prompt> | Invoke specific agent | | coc list | List all available agents | | coc teams | Show agent teams | | coc info <agent> | Show agent details |

Metacognition (MCL)

| Command | Description | |---------|-------------| | coc critique <target> | MCL critique of code/plan | | coc review <target> | Quick code review | | coc learn <outcome> | After-action review |

Chain-of-Verification (CoV)

| Command | Description | |---------|-------------| | coc verify <question> | Full CoV verification workflow | | coc cov <question> | Alias for verify | | coc quickverify <question> | Quick verification (3 workers) | | coc deepverify <question> | Deep verification (5+ workers) |

Project Management

| Command | Description | |---------|-------------| | coc init | Initialize project with agents | | coc update | Update agents from global | | coc orchestrate <prompt> | Full project orchestration |

Utility

| Command | Description | |---------|-------------| | coc shell | Interactive Claude Code | | coc config | Show configuration | | coc version | Show version | | coc help | Full documentation |

Agent Teams

Auto-Orchestration (5 agents)

Automated prompt routing and enhancement

• auto-orchestrator - Master pipeline controller
• prompt-analyzer - Intent extraction
• prompt-enhancer - Request enrichment
• intent-router - Agent selection
• smart-dispatcher - Fast routing

Metacognition (9 agents)

Self-aware reasoning and learning

• mcl-core - Central controller
• mcl-critic - Output evaluation
• mcl-regulator - Impulse control
• mcl-learner - Learning from outcomes
• agent-creator - Generate new agents

Chain-of-Verification (6 agents)

High-accuracy, bias-resistant verification

• cov-orchestrator - CoV workflow controller
• domain-expert-worker - Domain-specific factual validation
• counterexample-hunter-worker - Find edge cases, failure modes
• comparative-analyst-worker - Compare alternatives, tradeoffs
• risk-safety-reviewer-worker - Identify risks, policy concerns
• clarity-editor-worker - Improve clarity without changing meaning

AI Development (6 agents)

• llm-integration-architect
• rag-specialist
• prompt-engineer
• ai-agent-architect
• fine-tuning-specialist
• ml-ops-engineer

Quantum Computing (6 agents)

• quantum-circuit-designer
• quantum-algorithm-developer
• quantum-ml-researcher
• quantum-error-specialist
• quantum-simulation-expert

iOS Development (5 agents)

• swiftui-architect
• ios-performance-engineer
• swift-concurrency-expert
• apple-platform-integrator
• ios-testing-specialist

Web Development (3 agents)

• frontend-architect
• backend-architect
• fullstack-developer

DevOps (3 agents)

• cloud-architect
• ci-cd-engineer
• kubernetes-specialist

Security (2 agents)

• security-architect
• appsec-engineer

Examples

Building Features

# Full-stack feature
coc go "build a user profile page with avatar upload"

# API development
coc go "create REST endpoints for order management"

# iOS feature
coc agent swiftui-architect "design a settings screen with dark mode toggle"

Fixing Issues

# Bug fix
coc quick "fix the null pointer in UserService"

# Performance
coc go "optimize the slow database queries"

# Security
coc agent appsec-engineer "audit authentication module"

Code Quality

# Review
coc critique src/components/

# Refactor
coc go "refactor auth module for better testability"

# Documentation
coc agent doc-generator "document the API endpoints"

Project Orchestration

# Large projects
coc orchestrate "build an e-commerce platform with React and Node"
coc orchestrate "migrate monolith to microservices"

Chain-of-Verification

# Architectural decisions
coc verify "What's the best database for our high-write workload?"
coc deepverify "Should we use event sourcing or CRUD?"

# Technical recommendations
coc verify "Is our caching strategy optimal for read-heavy traffic?"
coc quickverify "Should we use WebSockets or SSE for real-time updates?"

Configuration

Craig-O-Code stores configuration in:

• CLI tools: ~/.local/bin/
• Agents: ~/.cursor/agents/
• Rules: ~/.cursorrules

Custom Configuration

Create ~/.coc-config for custom settings:

default_mode: balanced
verbose: false
auto_include:
  - code-reviewer
  - test-generator

Uninstall

npm

npm uninstall -g craig-o-code

From Source

./scripts/uninstall.sh

Manual Cleanup

rm ~/.local/bin/coc ~/.local/bin/craig ~/.local/bin/craig-o-code
rm -rf ~/.cursor/agents
rm ~/.cursorrules
rm ~/.craig-o-code-intro.sh

Troubleshooting

"Claude Code not found"

Install Claude Code:

npm install -g @anthropic-ai/claude-code
claude auth login

"Command not found: coc"

If installed via npm, ensure your npm global bin directory is in PATH:

npm config get prefix  # Shows npm prefix
export PATH="$(npm config get prefix)/bin:$PATH"

If installed from source, ensure ~/.local/bin is in your PATH:

export PATH="$HOME/.local/bin:$PATH"

Add to ~/.zshrc or ~/.bashrc for persistence.

Agents not loading

Reinstall agents via npm:

npm run install-agents

Or from source:

./scripts/install.sh --agents-only

Permission errors during npm install

If you encounter EACCES errors:

# Option 1: Use a node version manager (recommended)
nvm install --lts
nvm use --lts

# Option 2: Fix npm permissions
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Project Structure

craig-o-code/
├── agents/              # 68+ specialized AI agent definitions (including CoV team)
│   ├── metacognition/   # MCL (Metacognition Layer) agents
│   ├── teams/           # Organized agent teams
│   └── skills/          # Reusable agent skills
├── bin/                 # Executable CLI tools
│   ├── coc              # Main CLI entry point
│   ├── craig            # Shortcut alias
│   └── auto-route.sh    # Smart routing logic
├── docs/                # Documentation
│   ├── ALIASES.md       # Shell alias reference
│   ├── COV-QUICKSTART.md        # CoV update & usage guide
│   ├── FUNCTIONGEMMA_CONFIG.md  # Local model configuration
│   ├── DISTRIBUTION-READY.md    # Distribution guide
│   └── adr/             # Architecture decision records
├── macos-installer/     # macOS installer build system
│   ├── build-all.sh     # Complete build pipeline
│   ├── build-dist.sh    # Create DMG and ZIP
│   └── build-pkg.sh     # Build installer package
├── resources/           # Images and assets
│   └── Craig-O-Code.png # Project logo
├── scripts/             # Utility scripts
│   ├── install.sh       # Installation script (bash)
│   ├── npm-postinstall.js # npm postinstall script (Node.js)
│   ├── uninstall.sh     # Uninstallation script
│   └── QUICK_RELOAD.sh  # Alias reload helper
├── CHANGELOG.md         # Version history
├── README.md            # This file
├── VERSION              # Current version number
└── package.json         # NPM package definition

License

MIT License - NeuralQuantum.ai

Links

• VibeCaaS.com: https://vibecaas.com
• NeuralQuantum.ai: https://NeuralQuantum.ai
• Claude Code: https://claude.ai/code
• Issues: https://github.com/ttracx/craig-o-code/issues

© 2025 Craig-O-Code powered by VibeCaaS.com, a division of NeuralQuantum.ai LLC. All rights reserved.