MonkeysCode CLI

AI-powered coding agent for the terminal. Works on macOS, Linux, and Windows.

Quick Install

# macOS / Linux
curl -fsSL https://monkeyscode.com/install.sh | sh

# Windows (PowerShell)
irm https://monkeyscode.com/install.ps1 | iex

# npm
npm install -g @monkeyscode/cli

# Homebrew
brew install monkeyscode

Usage

# Interactive REPL
mc "refactor the auth module"

# Headless (CI/CD)
mc -p "fix all lint errors" --headless --auto-approve

# Background job with auto-PR
mc -p "write tests" --background --auto-branch --auto-pr

# Pipe mode
echo "explain this error" | mc

# Model selection
mc --model claude-opus "deep architecture review"

Features

🤖 Multi-Model Support

Switch between Claude, GPT-4o, Gemini, and MonkeysCode's own Capuchin model.

mc --model auto "fix the bug"       # Smart model selection
mc --model claude-opus "review PR"  # Specific model

📁 Full Tool Suite

The agent can edit files, run terminal commands, search code, and manage git — all locally.

🔒 Sandboxed Execution

Run agent commands in isolated sandboxes (bubblewrap, sandbox-exec, Docker).

mc --sandbox "run the migration script"
mc --sandbox-network=none "process sensitive data"

🌐 Background Jobs

Submit long-running tasks to the cloud and get notified when done.

mc -p "write comprehensive tests" --background --auto-pr
mc jobs list
mc jobs logs abc123 --follow

🧠 Memory & Conventions

The agent learns your project's conventions and remembers them.

mc memory add "Always use camelCase for variables"
mc memory show
mc dream           # Consolidate session history into memory

⚡ CI/CD Integration

Run headlessly in GitHub Actions, GitLab CI, or any CI system.

# .github/workflows/review.yml
- uses: MonkeysCloud/monkeyscode@main
  with:
    prompt: 'Review this PR'
    mode: plan
    output: github
    api-key: ${{ secrets.MONKEYSCODE_API_KEY }}

🔌 MCP Servers

Extend the agent with custom tools via the Model Context Protocol.

mc mcp add jira npx @monkeyscode/mcp-jira
mc mcp add slack npx @monkeyscode/mcp-slack
mc mcp list

👥 Multi-Agent Teams

Spawn parallel agents to divide and conquer large tasks.

mc team spawn --task "Implement auth, payments, and email modules"
mc team status
mc team merge team-abc123

Output Formats

| Format | Use Case | |--------|----------| | text | Interactive terminal (default) | | json | Structured result for scripts | | jsonl | Streaming events for real-time parsing | | diff | Unified diff (git apply compatible) | | markdown | Clean markdown (for PR descriptions) | | github | GitHub Actions output format | | azure | Azure DevOps format | | sarif | SARIF 2.1.0 for code scanning |

Configuration

mc config set defaultModel claude-sonnet    # Set default model
mc config set theme dark                     # Set theme
mc config list                               # Show all settings
mc config path                               # Show config file locations

Project-level config: .monkeyscode/config.json

Shell Completions

mc completions bash >> ~/.bashrc
mc completions zsh >> ~/.zshrc
mc completions fish > ~/.config/fish/completions/mc.fish
mc completions powershell >> $PROFILE

Slash Commands (REPL)

| Command | Description | |---------|-------------| | /help | Show all commands | | /model <name> | Switch model | | /mode <mode> | Switch mode (agent/plan/ask) | | /compact | Toggle compact output | | /diff | Show session changes | | /undo | Revert last edit | | /commit [msg] | Commit changes | | /files | List touched files | | /cost | Show token usage | | /vim | Toggle Vim keybindings | | /cloud | Hand off to cloud | | /context <file> | Add file to context |

SDK

Build custom integrations with the TypeScript SDK:

npm install @monkeyscode/sdk

import { MonkeysCode } from '@monkeyscode/sdk';

const agent = new MonkeysCode({ apiKey: process.env.MONKEYSCODE_API_KEY });
const result = await agent.run('Fix all TypeScript errors');
console.log(result.summary);

See @monkeyscode/sdk for full documentation.

Accessibility

Screen reader-friendly mode (no ANSI codes, no animations):

mc --accessible "fix the bug"
# or
export MONKEYSCODE_ACCESSIBLE=1

Telemetry

Telemetry is enabled by default and collects anonymous usage data to improve the product.

mc telemetry status    # Check status
mc telemetry disable   # Opt out
mc telemetry show      # See what's collected

Respects the DO_NOT_TRACK=1 environment variable.

Documentation

• CLI Overview
• Core Runtime
• Interactive Experience
• Auth & Configuration
• Headless / CI/CD
• Background & Cloud
• Distribution
• SDK & Extensibility

License

MIT © MonkeysCloud Corp