OpenCode

What You'll Get

Total setup time: ~2 minutes to connect, then the agent does the rest.

Step 1: Add the MCP Server

Add the Stable Baseline MCP server to OpenCode. Create or edit the opencode.json file:

Using an API Key (recommended)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stablebaseline-mcp": {
      "type": "remote",
      "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
      "headers": {
        "Authorization": "Bearer {env:STABLE_BASELINE_API_KEY}"
      }
    }
  }
}

Set your API key as an environment variable or in a .env file:

Using OAuth 2.1 (alternative)

If your organization uses OAuth, OpenCode supports the MCP Authorization spec with automatic OAuth discovery:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stablebaseline-mcp": {
      "type": "remote",
      "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

OpenCode discovers the OAuth endpoints automatically via the Protected Resource Metadata spec (RFC 9728). On first use, it detects the 401 response and initiates the OAuth flow in your browser — no manual configuration required.

You can also manage OAuth sessions from the CLI:
opencode mcp auth stablebaseline-mcp # Authenticate
opencode mcp list # Check connection status
opencode mcp logout stablebaseline-mcp # Sign out

Project vs Global Config

We recommend project-level config so every team member gets Stable Baseline automatically when they clone the repo.

Step 2: Run Setup

Open OpenCode in your terminal and run the slash command /stablebaseline-mcp:sb-setup:mcp. That's it — the agent handles everything from here.

/stablebaseline-mcp:sb-setup:mcp

What it does (in order):

1. Verifies the MCP connection — If it can't connect, it tells you exactly what to fix and waits for you to say "continue"
2. Resolves your workspace & project — If you have multiple, it asks you to pick. If you have none, it links you to app.stablebaseline.io to create them and waits for you
3. Creates .sb/config.json — Caches your workspace and project IDs locally
4. Checks for existing documentation — If the project already has docs (e.g. created manually in the app), it shows you what's there and asks whether to augment (fill gaps), replace (start fresh), or cancel
5. Analyzes your repository — Tech stack, architecture, directory structure, dependencies, security model, infrastructure, domain context, and more
6. Designs a bespoke documentation structure — No fixed template. The structure is tailored to YOUR repo's natural boundaries — by service, by domain, by layer, whatever fits
7. Creates the documentation in Stable Baseline — Real content with diagrams, not stubs. A developer joining tomorrow should be able to read these docs and understand the system
8. Generates AGENTS.md — A cross-IDE auto-sync rule file at your repo root with file-pattern-to-document mappings specific to your codebase
9. Provides a summary — Everything it created, with a tree view and next steps

If anything goes wrong at steps 1 or 2 (connection issues, missing workspace/project), the agent stops, tells you exactly what to do, and waits for you to type continue after you've fixed it. If the project already has documentation (step 4), the agent shows you what exists and lets you choose how to proceed — no surprise overwrites. No need to start over.

What Gets Documented

The agent doesn't follow a checklist. It reads your code and documents what matters for THIS repo. Areas it considers:

Technical and business documentation sit side by side — consistent and driving outcomes from each other.

How Auto-Sync Works

The AGENTS.md file generated in Step 2 contains a table mapping your repo's file patterns to Stable Baseline documents:

These patterns are specific to YOUR repo. When OpenCode's agent changes files matching a pattern, it knows which Stable Baseline document to update — and does so automatically using the MCP tools.

AGENTS.md is the cross-IDE standard (Linux Foundation / Agentic AI Foundation). It works in OpenCode, Cursor, VS Code Copilot, Claude Code, Windsurf, Zed, Warp, Roo Code, Aider, and 15+ other tools. Switch IDEs and the auto-sync rules follow.

File Structure

After setup, your project root will have:

your-project/
├── opencode.json         # MCP server config (Step 1)
├── .sb/
│   └── config.json       # Project IDs (auto-generated)
├── AGENTS.md             # Cross-IDE auto-sync rules (auto-generated)
└── ...

All files are safe to commit to git. When using an API key with {env:STABLE_BASELINE_API_KEY}, the key stays in your environment — not in the config file. Or use OAuth to avoid secrets entirely. Add .sb/ to .gitignore if you prefer to keep IDs local.

Try It

Your baseline docs are ready. Here are some prompts to try next:

Regenerate Documentation

Need to start fresh? Tell OpenCode:

Delete all existing folders and documents in my Stable Baseline project,
then re-run the /stablebaseline-mcp:sb-setup:mcp command to regenerate everything from scratch.