Updated 2026-08-07

Codebuff

Codebuff is an open-source terminal agent (installed via npm i -g codebuff) that reads MCP server configuration from .agents/mcp.json with a mcpServers object of { command, args, env } entries. Only stdio transport is documented.

Install with the CLI (fastest)

Run npx lyrashield install codebuff from your project root. It detects Codebuff, writes the correct config automatically, and never inlines your API key into a file you might commit. Add --dry-run first to preview the change with no write, or run npx lyrashield doctor afterward to confirm it's configured correctly.

npx lyrashield install codebuff

Prefer to see exactly what gets written, or set it up without Node.js? Configure it by hand below.

Local stdio setup

Add the following to .agents/mcp.json. Create the file if it does not exist.

Add the following to .agents/mcp.json. Recommended: run npx lyrashield login --oauth once; the local MCP server reads the selected workspace credential from ~/.lyrashield/credentials.json.

{
  "mcpServers": {
    "lyrashield": {
      "command": "npx",
      "args": [
        "-y",
        "@lyrashield/mcp"
      ],
      "env": {
        "LYRASHIELD_API_URL": "https://app.lyrashieldai.com"
      }
    }
  }
}

npx lyrashield install codebuff

Important gotchas

• Config lives at `.agents/mcp.json` with a `mcpServers` object of `{ command, args, env }`; open-source terminal agent installed via `npm i -g codebuff`.
• Only stdio transport is documented, so this entry is stdio-only. Supports `/init` and `/publish` and an agent store.

Verify the connection

Start Codebuff and ask: "What LyraShield tools do you have access to?" to confirm the server is connected. Codebuff also supports /init and /publish commands and an agent store.