Opencode Workbench MCP server

OpenCode Workbench

A reproducible, self-documenting, and recoverable OpenCode development workstation — configuration, agent skills, MCP stack, and an MCP server that clones the entire setup onto any Linux machine (locally or over SSH).

Purpose

This repository is the single source of truth for a complete cloud development workstation. Everything needed to rebuild from scratch is versioned here:

• Workstation configuration and automation
• OpenCode configuration (model, providers, MCP servers)
• Agent skills (45 reusable AI instructions across research, dev, data, science and ops)
• Operational prompts (disaster recovery, backup, security)
• Recovery procedures (playbook, checklist, gap analysis)
• Security governance (secret management, threat model)
• opencode-workbench — an MCP server that installs this profile on any Linux box

No important knowledge exists only in human memory.

Clone This Workbench to Another Linux Machine

Register the MCP server with OpenCode:

{
  "mcp": {
    "opencode-workbench": {
      "type": "local",
      "command": ["npx", "-y", "@simonmak-ascent/opencode-workbench"],
      "enabled": true,
      "timeout": 600000
    }
  }
}

Then ask the agent to run inspecttarget → planclone → applyclone { confirm: true } → verifyclone, for { "mode": "local" } or { "mode": "ssh", "host": "", "user": "" }. applyclone is consent-gated: without confirm:true it returns a plan (components + privileged-command preview) and changes nothing. Run listrequired_credentials to see which keys the box still needs and how to acquire them, and bash scripts/selftest/run-selftest.sh to verify it works. See mcp-server/README.md and docs/architecture/clone-mcp.md.

The clone is key-resilient: with no model key it still boots on the OpenCode Zen free floor, and MCP servers whose credentials are absent are disabled and reported (not left to fail at runtime).

The connector never reads or transmits secret values; it writes an empty ~/.env.workbench template for you to fill in.

Quick Start

# Create a new build box
gh SWAS create --repo simonmak-ascent/opencode-workbench --machine basicLinux32gb

# Wait for postCreate (3-5 min) — installs everything automatically
# Then start coding:
opencode

Architecture

Shortened. The full README is on GitHub.