# stanp-opencode

stanp-opencode is an OpenCode V2 coordinator with specialist workers for fast, good, and deep tasks.

## Install the latest release

Requires OpenCode V2 2.0.2 (`opencode2`), Bun 1.3.14+, Bash, curl, jq, and `sha256sum` on Linux or WSL.

Run the installer without sudo:

```sh
curl -fsSL https://git.krtss.de/StanPonomarev/stanp-opencode/raw/branch/main/install.sh | bash
```

Pass `--playwright` to let the plugin automatically configure a Playwright MCP server:

```sh
curl -fsSL https://git.krtss.de/StanPonomarev/stanp-opencode/raw/branch/main/install.sh | bash -s -- --playwright
```

Rerun the command to upgrade to the latest published release.

## Install from a local checkout

This requires Bash, jq, and Bun 1.3.14+:

```sh
bash /path/to/stanp-opencode/install-local.sh
```

Add `--playwright` to this command to enable automatic Playwright MCP configuration.

The script installs dependencies and builds the checkout before installing it.

After either installation, restart `opencode2` or run `opencode2 service restart` for an existing service. Connect OpenAI and select `coordinate`. The required models must be available for the workers to run.

Both installers use `~/.config/opencode`, respect `XDG_CONFIG_HOME`, and accept `OPENCODE_CONFIG_DIR` as an override.

## Configuration

See [GPT configuration](examples/gpt.opencode.jsonc) and [custom model assignments](examples/custom.opencode.jsonc).

For an installed plugin, use `./plugins/stanp-opencode` as the plugin package path. Set `lunaPriority` to `false` to avoid requesting priority pricing.

## Playwright

When installed with `--playwright`, the plugin prefers a local Playwright MCP installation. If ordinary Playwright is installed, it can download and run the MCP package with `npx`; otherwise Docker is required for the automatic fallback. Automatically configured servers allow five minutes for startup because the first launch may need to download a package or container image. Docker reuses its cached image on later launches. Existing `playwright` configuration, including its timeout, is preserved.

If `opencode mcp list` reports `MCP error -32001: Request timed out`, prefetch the Docker fallback with `docker pull mcr.microsoft.com/playwright/mcp`, or install `@playwright/mcp` in the project so the plugin can launch it directly. Then reconnect the server from `/mcps` or restart OpenCode. A custom `playwright` entry under `mcp.servers` can also set its own `timeout.startup` in milliseconds.

## Uninstall

Remove `plugins/stanp-opencode` from the selected configuration directory and remove its configuration entry, then restart OpenCode.