Skip to main content

​
CLI Commands

Mega Brain provides a comprehensive CLI for installation, setup, and system management.

​
Installation

npx mega-brain-ai <command> [options]

​
Commands

​
install

Install Mega Brain into a new or existing project.
​
name
string
Optional project name. If omitted, uses current directory name.
Usage: 
npx mega-brain-ai install
npx mega-brain-ai install my-project
Behavior:
  • Creates directory structure (core/, agents/, .claude/, etc.)
  • Copies templates and hooks
  • Initializes .env file
  • Sets up git repository with layer system
Location: bin/mega-brain.js:65-67

​
setup

Interactive setup wizard for API keys and dependencies. Usage: 
npx mega-brain-ai setup
Behavior:
  • Prompts for API keys (OpenAI, Voyage, Google)
  • Validates credentials
  • Writes to .env file
  • Installs Python dependencies
  • Runs system health check
Auto-trigger: Runs automatically on first use if .env is missing Location: bin/mega-brain.js:95-97

​
validate

Validate MoneyClub email for Premium access.
​
email
string
required
Email address to validate
Usage: 
npx mega-brain-ai validate user@moneyclub.com
Returns:
  • Exit code 0: Email valid
  • Exit code 1: Email invalid
Location: bin/mega-brain.js:68-77

​
push

Push changes to Layer 1/2/3 remote repositories.
​
--layer
number
Specific layer to push (1, 2, or 3). If omitted, pushes current layer.
Usage: 
npx mega-brain-ai push
npx mega-brain-ai push --layer 1
npx mega-brain-ai push --layer 2
Layers:
  • Layer 1 (Community): Public shell - core templates, hooks, and CLI
  • Layer 2 (Premium): Shell + brain - includes agents and knowledge base
  • Layer 3 (Personal): Full backup - includes sensitive data and personal agents
Location: bin/mega-brain.js:78-80

​
upgrade

Upgrade from Community to Premium version. Usage: 
npx mega-brain-ai upgrade
Behavior:
  • Validates MoneyClub membership
  • Downloads Premium assets
  • Updates agent registry
  • Enables Pro features
Location: bin/mega-brain.js:81-88

​
status

Show Pro license status and feature availability. Usage: 
npx mega-brain-ai status
Output: 
═══════════════════════════════════════
MEGA BRAIN PRO STATUS
═══════════════════════════════════════
Version: Premium
License: MoneyClub (user@example.com)
Expires: 2026-12-31

Features Enabled:
✓ Mind Clone Agents (5/5)
✓ Pipeline Processing
✓ Council/Conclave
✓ Knowledge Base
Location: bin/mega-brain.js:89-91

​
features

List available vs locked features. Usage: 
npx mega-brain-ai features
Output: 
═══════════════════════════════════════
FEATURE COMPARISON
═══════════════════════════════════════

COMMUNITY (Current):
✓ CLI & Templates
✓ Skills & Hooks
✓ Agent Templates
✗ Knowledge Base (populated)
✗ Mind Clone Agents
✗ Pipeline Processing
✗ Council/Conclave

PREMIUM:
✓ All Community features
✓ Populated knowledge base
✓ 5 Mind clone agents
✓ Full pipeline processing
✓ Multi-agent deliberation
Location: bin/mega-brain.js:92-94

​
—help

Show help message with all available commands. Usage: 
npx mega-brain-ai --help
npx mega-brain-ai -h
Location: bin/mega-brain.js:105-131

​
Environment Variables

All configuration is managed through .env file:
​
OPENAI_API_KEY
string
required
OpenAI API key for Whisper transcription. Required for pipeline processing.
​
VOYAGE_API_KEY
string
Voyage AI API key for semantic embeddings and RAG search. Recommended for knowledge retrieval.
​
GOOGLE_CLIENT_ID
string
Google OAuth client ID for Drive import functionality. Optional.
​
GOOGLE_CLIENT_SECRET
string
Google OAuth client secret for Drive import. Optional.
​
ANTHROPIC_API_KEY
string
Not required when using Claude Code. Only needed for direct API usage.

​
Exit Codes

CodeMeaning
0Success
1General error
100Timeout (2 minutes)

​
Notes

The CLI uses Node.js 21+ native .env loading. No external dependencies required.
Never commit .env file to version control. It’s automatically gitignored.

Build docs developers (and LLMs) love

Get started for freeTalk to us