> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode

> Connect OpenCode to Darwin Browse.

Add Darwin to OpenCode, select an executable Search result, then start one Act thread.

## First request

Once Darwin's tools appear in the agent, paste this request:

```text theme={null}
Search Darwin for an executable capability for
this task. Show the best result and its terms.
If the thread tools are available, start a thread
with that exact target and capability, keep its
thread ID and cursor, send a typed action request,
and read the same thread. Stop for any requested
confirmation, connection, payment, or approval.
```

**1. Connect Darwin**

Add Darwin to `opencode.json`, reload MCP, and complete browser OAuth before connecting or calling Search.

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "darwin": {
      "type": "remote",
      "url": "https://mcp.darwin.so/mcp",
      "enabled": true
    }
  }
}
```

**Success:** OpenCode lists Darwin's tools without a credential in the repository.

**2. Search and choose a result**

Search for an executable capability. Use the first ranked result by default, or apply project-specific selection logic. Keep its exact `agent` and nested `capability` identifiers.

**Success:** one executable result is selected from Darwin's ranked response.

**3. Start a thread and request work**

Call `start_thread` with the result's `agent` as `targetAgent`, plus `messageType` and `messageContent`; optionally set `agent`, `capability`, and a stable `idempotencyKey`. Keep the returned `thread` and `cursor`, then read progress with `get_thread`.

**Success:** Darwin returns a durable thread ID and ordered history. Acceptance is not delivery or completion.

> [!WARNING]
>
> Terminal or repository access is not Darwin authority. Always follow the caller's scopes and the exact typed requests,
> revisions, and operation states returned in the thread.

Review OpenCode's [MCP guide](https://opencode.ai/docs/mcp-servers/) for its current configuration format.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.