Excellent in OpenCode, as one entry in its own config
The installer writes one excellent entry into ~/.config/opencode/opencode.json, in JSON, under mcp, and leaves the rest of the file alone. Restart OpenCode afterwards: it only sees the new server after a restart.
curl -fsSL https://excellent.so/install.sh | shIt runs excellent install-agent-mcps, which writes the entry and prints OpenCode: linked.
The entry and the setup prompt
Set up Excellent (excellent.so) in OpenCode for me. First run: curl -fsSL https://excellent.so/install.sh | sh
If its output has a line starting "OpenCode: linked" or "OpenCode: already-linked", skip to the last step.
Otherwise open ~/.config/opencode/opencode.json (create it as {} if it is missing) and add this under the top-level "mcp" object, creating that object if needed and keeping everything else in the file unchanged:
"excellent": {"type":"local","command":["/absolute/path/to/node","/absolute/path/to/@excellent-so/cli/dist/server.js"],"cwd":"/absolute/path/to/@excellent-so/cli/dist","environment":{},"enabled":true}
If the file nests servers under "mcp": {"servers": {...}}, put it there instead, with "disabled": false in place of "enabled": true.
Replace /absolute/path/to/node with the output of `node -p process.execPath`, and /absolute/path/to/@excellent-so/cli/dist with the output of `echo "$(npm root -g)/@excellent-so/cli/dist"`.
Last step: tell me to restart OpenCode, because it only sees the new server after a restart.It runs the installer and looks for OpenCode: linked; if that line is missing it adds the entry by hand, then asks you to restart.
- Agent
- OpenCodeAnomaly
- Config file
~/.config/opencode/opencode.jsonmacOS- Linux, Windows
- Linux: the same path. Windows:
%USERPROFILE%\.config\opencode\opencode.jsonNot supported yet - Format
- JSON, under
mcpmcp, a local server with command as one array - Detected by
- the opencode binary or the opencode2 binary
- The installer prints
OpenCode: linked- Restart
- Restart OpenCode afterwards: it only sees the new server after a restart.
- Undo
- Delete the "excellent" entry under "mcp" in ~/.config/opencode/opencode.json, then restart OpenCode.
- Source
micro packages/core/src/agent-clis.ts:689
OpenCode docs
The CLI on npm today, 0.1.0 (checked October 23, 2026), predates install-agent-mcps: the installer skips this step, says so, and changes no agent config. Paste the setup prompt, or add the entry by hand as the setup doc shows.
The same entry
Put Excellent in your agent: install it, restart the agent, run one task
curl -fsSL https://excellent.so/install.sh | sh
Names and marks belong to their owners. Shown to say Excellent works with these agents, with no endorsement implied.