OpenCode Setup

A reproduction of claude-code-setup (Anthropic's official plugin), adapted to OpenCode.

Analyzes your codebase and recommends the most useful OpenCode automations — MCP servers, skills, subagents, commands, and plugins/hooks. It is read-only: it recommends, it never modifies your files.

How it works

Like the original, the core is an LLM-driven skill (not a fixed detection script). It follows a 3-phase workflow — scan → map → report — backed by detailed reference files. It surfaces the top 1-2 automations per category (or 3-5 if you ask for a specific category).

opencode-setup/
├── skills/opencode-automation-recommender/
│   ├── SKILL.md                       # the brain (workflow + decision framework)
│   └── references/
│       ├── mcp-servers.md             # context7, Playwright, Supabase, GitHub…
│       ├── skills-reference.md        # custom skills to create
│       ├── subagents.md               # code-reviewer, security-reviewer…
│       ├── commands.md                # /test, /pr, /review…
│       └── plugins-hooks.md           # format/lint/block via the plugin API
├── command/setup.md                   # the /setup command (trigger)
└── plugin/index.js                    # read-only `project-scan` tool (ESM)

claude-code-setup → OpenCode mapping

| claude-code-setup | OpenCode | |---|---| | MCP Servers | mcp block in opencode.jsonc (type: local/remote) | | Skills | .opencode/skills/<n>/SKILL.md | | Subagents | .opencode/agent/<n>.md (mode: subagent) | | Slash Commands | .opencode/command/<n>.md | | Hooks | OpenCode plugin API (tool.execute.before/after, event) — OpenCode has no separate hooks config |

Installation

npm (recommended)

npx @sunderrrr/opencode-setup

Cross-platform. Installs the skill, the /setup command, and the project-scan plugin into ~/.config/opencode/. Override the target with OPENCODE_CONFIG=/path npx @sunderrrr/opencode-setup.

curl

curl -fsSL https://raw.githubusercontent.com/Sunderrrr/opencode-setup/main/install.sh | bash

Both methods install the same files into ~/.config/opencode/.

Usage

In OpenCode:

/setup

or simply, in natural language (the skill triggers itself):

recommend automations for this project
help me set up OpenCode for this project
what plugins/hooks should I use?

Requirements

• OpenCode 1.17+
• Node 18+ (for npx); or curl for the shell installer

Publishing (maintainers)

Releases are published to npm automatically by .github/workflows/publish.yml when a GitHub Release is published. One-time setup:

1. Create an npm automation access token (npmjs.com → Access Tokens).
2. Add it as the repo secret NPM_TOKEN (Settings → Secrets and variables → Actions).
3. Bump version in package.json, then publish a GitHub Release tagged vX.Y.Z (the tag must match the package version). The workflow runs npm publish with provenance enabled.

To publish manually instead:

npm publish   # uses publishConfig.access=public + provenance

License

MIT