Excellent in Codebuff, as one entry in its own config

The installer writes one excellent entry into ~/.agents/mcp.json, in JSON, under mcpServers, and leaves the rest of the file alone. Restart Codebuff afterwards: it only sees the new server after a restart.

curl -fsSL https://excellent.so/install.sh | sh

It runs excellent install-agent-mcps, which writes the entry and prints Codebuff: linked.

~/.agents/mcp.json

{

"mcpServers": {

"excellent": {

"type": "stdio",

"command": "/absolute/path/to/node",

"args": [

"/absolute/path/to/@excellent-so/cli/dist/server.js"

"cwd": "/absolute/path/to/@excellent-so/cli/dist",

"env": {}

}

Setup prompt · paste it into Codebuff

Set up Excellent (excellent.so) in Codebuff for me. First run: curl -fsSL https://excellent.so/install.sh | sh
If its output has a line starting "Codebuff: linked" or "Codebuff: already-linked", skip to the last step.
Otherwise open ~/.agents/mcp.json (create it as {} if it is missing) and add this under the top-level "mcpServers" object, creating that object if needed and keeping everything else in the file unchanged:
"excellent": {"type":"stdio","command":"/absolute/path/to/node","args":["/absolute/path/to/@excellent-so/cli/dist/server.js"],"cwd":"/absolute/path/to/@excellent-so/cli/dist","env":{}}
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 Codebuff, because it only sees the new server after a restart.

It runs the installer and looks for Codebuff: linked; if that line is missing it adds the entry by hand, then asks you to restart.

Agent: CodebuffCodebuff
Config file: ~/.agents/mcp.jsonmacOS
Linux, Windows: Linux: the same path. Windows: %USERPROFILE%\.agents\mcp.jsonNot supported yet
Format: JSON, under mcpServersmcpServers, with type: "stdio"
Detected by: the codebuff binary
The installer prints: Codebuff: linked
Restart: Restart Codebuff afterwards: it only sees the new server after a restart.
Undo: Delete the "excellent" entry under "mcpServers" in ~/.agents/mcp.json, then restart Codebuff.
Source: micro packages/core/src/agent-clis.ts:857
Codebuff 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