# Install stable v2.2
npm install cognitive-modules-cli@2.2.1
# or install the alias package (same `cog` command)
npm install cogn@2.2.1
pip install cognitive-modules==2.2.1

# Install beta v2.5 (streaming + multimodal)
npm install cognitive-modules-cli@beta
pip install cognitive-modules==2.5.0b1

# Zero-install quick start (recommended)
npx cogn@2.2.1 run code-reviewer --args "your code"

# Or use the full package name
npx cognitive-modules-cli@2.2.1 run code-reviewer --args "your code"

# Global installation
npm install -g cogn@2.2.1
# or: npm install -g cognitive-modules-cli@2.2.1

pip install cognitive-modules==2.2.1

# With LLM support
pip install "cognitive-modules[openai]==2.2.1"      # OpenAI
pip install "cognitive-modules[anthropic]==2.2.1"   # Claude
pip install "cognitive-modules[all]==2.2.1"         # All providers

# Configure LLM
export LLM_PROVIDER=openai
export OPENAI_API_KEY=sk-xxx

# Run code review (npm)
npx cogn run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty

# Or use globally installed cog command
cog run code-reviewer --args "..." --pretty

# Run task prioritization
cog run task-prioritizer --args "fix bug(urgent), write docs, optimize performance" --pretty

# Run API design
cog run api-designer --args "user system CRUD API" --pretty

# Start HTTP service (API integration)
cog serve --port 8000

# Start MCP server (Claude Code / Cursor integration)
cog mcp

# Module management
cog list                    # List installed modules
cog info <module>           # View module details
cog validate <module>       # Validate module structure
cog validate <module> --v22 # Validate v2.2 format

# Run modules
cog run <module> input.json -o output.json --pretty
cog run <module> --args "requirements" --pretty
cog run <module> --args "requirements" --subagent  # Enable subagent

# Create modules
cog init <name> -d "description"
cog init <name> --format v22  # Create v2.2 format module

# Migrate modules
cog migrate <module>        # Migrate v1/v2.1 module to v2.2

# Install from GitHub (recommended)
cog add ziel-io/cognitive-modules -m code-simplifier
cog add org/repo -m module-name --tag v1.0.0   # Install specific version
cog remove <module>                             # Remove module

# Version management
cog update <module>                 # Update to latest version
cog update <module> --tag v2.0.0    # Update to specific version
cog versions <url>                  # View available versions

# Other installation methods
cog install github:user/repo/path
cog install registry:module-name
cog uninstall <module>

# Registry
cog registry                # View public modules
cog search <query>          # Search modules

# Environment check
cog doctor

# OpenAI
export LLM_PROVIDER=openai
export OPENAI_API_KEY=sk-xxx

# Anthropic Claude
export LLM_PROVIDER=anthropic
export ANTHROPIC_API_KEY=sk-ant-xxx

# MiniMax
export LLM_PROVIDER=minimax
export MINIMAX_API_KEY=sk-xxx

# Ollama (local)
export LLM_PROVIDER=ollama

# Check configuration
cog doctor

# Auto-migrate single module
cog migrate code-reviewer

# Migrate all modules
cog migrate --all

# Verify migration result
cog validate code-reviewer --v22

# Clone
git clone https://github.com/ziel-io/cognitive-modules.git
cd cognitive-modules

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Create new module (v2.2 format)
cog init my-module -d "module description" --format v22
cog validate my-module --v22