opencode-ask-manus

An OpenCode plugin that wraps the Manus API — gives any agent the ability to delegate tasks to Manus, an AI agent with its own tools, sandbox, and web access.

Installation

As a plugin (recommended)

From npm:

{
  "plugin": ["opencode-ask-manus"]
}

From local files: copy to your plugin directory:

cp -r opencode-ask-manus ~/.config/opencode/plugins/opencode-ask-manus

As a custom tool

cp tools/manus.ts .opencode/tools/manus.ts

As an MCP server (fallback)

cd mcp && npm install

See mcp/opencode.json for the MCP registration snippet.

Set your API key

export MANUS_API_KEY="your_key_here"

Subagent config

The plugin registers a manus subagent scoped to only the Manus tools. Add this to your opencode.json:

{
  "tools": { "manus_*": false },
  "agent": {
    "manus": {
      "mode": "subagent",
      "description": "Delegates tasks to Manus.",
      "tools": ["manus_run", "manus_send"]
    }
  }
}

Usage

@manus research the latest breaking changes in React 19 and summarise them

Tools

| Tool | Purpose | |------|---------| | manus_run | Create a new Manus task and block until it finishes | | manus_send | Send a follow-up message to an existing task |

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | MANUS_API_KEY | (required) | Your Manus API key | | MANUS_API_URL | https://api.manus.ai/v2 | Override the API base URL | | MANUS_POLL_INTERVAL | 4000 | Polling interval in ms | | MANUS_POLL_TIMEOUT | 600000 | Max wait time in ms (10 min) | | MANUS_AGENT_PROFILE | manus-1.6 | Agent profile: manus-1.6, manus-1.6-lite, or manus-1.6-max |

Architecture

Primary agent → @manus → subagent → manus_run → POST /v2/task.create → Manus cloud
                                              → GET /v2/task.listMessages (poll loop)
                                              → returns <manus_task id="…">…</manus_task>