ACP (Agent Context Protocol)

ACP (Agent Context Protocol) lets you use Mona inside compatible code editors. She can read your open files, suggest edits, and execute commands — all from within your IDE.

Supported editors

Installation

ACP support ships with the standard [all] extras. If you installed the minimal bundle:

cd ~/.monoclaw/monoclaw-runtime
uv pip install -e ".[acp]"

VS Code setup

1. Install the ACP extension from the marketplace
2. Open Command Palette (Cmd+Shift+P) → ACP: Connect Agent
3. Select MonoClaw from the list
4. The extension will auto-detect your monoclaw-acp binary

Zed setup

1. Open Settings → AI Assistant
2. Select MonoClaw as the provider
3. Zed will launch monoclaw-acp automatically

JetBrains setup

1. Install the ACP plugin from the marketplace
2. Go to Settings → Tools → ACP
3. Set the path to monoclaw-acp
4. Click Test Connection

How ACP works

1. The editor launches monoclaw-acp as a subprocess
2. ACP communicates via stdin/stdout using the Agent Context Protocol
3. Mona receives:
   • Open file contents
   • Cursor position
   • Selected text
   • Project structure
4. Mona responds with:
   • Text edits
   • Terminal commands
   • Explanations

Features

Inline edits

Highlight code and ask Mona to modify it:

Refactor this function to use async/await

Mona suggests the edit inline with a diff view.

Terminal integration

Run commands from the editor:

Run the test suite

Mona executes npm test and shows results in the editor's terminal panel.

Context awareness

Mona automatically sees:

• The current file
• Recently opened files
• Git status
• Error messages (if integrated with the editor's diagnostics)

Configuration

# ~/.monoclaw/config.yaml
acp:
  enabled: true
  editor:
    vs_code:
      auto_accept: false      # Require confirmation for edits
      show_diff: true         # Show diff before applying
    zed:
      auto_accept: true
      show_diff: false

Security

• ACP runs with the same permissions as your user account
• Dangerous commands require approval (if approval mode is enabled)
• File edits can be reviewed before applying
• No code is sent to external services beyond your configured LLM provider

Troubleshooting