stanp-opencode

OpenCode V2 plugin providing a coordinate agent and fast/good/deep worker pairs, with GPT routing or explicit custom model assignments. Your default agent and the built-in build agent remain unchanged.

Install the latest release

Requires OpenCode V2 (opencode2), Bun 1.3.14+, Bash, curl, jq, and sha256sum (Linux/WSL). The native plugin API is pinned to @opencode/plugin@0.0.0-beta-19378; use the matching OpenCode beta.

Run the installer without sudo:

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

From a checkout, run bash install.sh directly. Rerun the same script to upgrade to the latest published, non-prerelease Gitea release.

The installer downloads stanp-opencode.tgz and its SHA-256 checksum, verifies and extracts the self-contained archive, then activates the plugin only after importing and checking the native V2 export. Download, extraction, and validation failures leave the previous active plugin untouched. The checksum detects corruption; it is not a signature independent of the release server.

Installation defaults to ~/.config/opencode and respects XDG_CONFIG_HOME. Override it explicitly when needed:

OPENCODE_CONFIG_DIR=/path/to/opencode-config bash install.sh

The installer atomically replaces the package directory at plugins/stanp-opencode and adds its default GPT configuration to opencode.json. Existing unrelated JSON settings and opencode.jsonc are preserved. It does not create symlinks, install package dependencies, install OpenCode itself, or configure provider credentials.

Restart opencode2 after installation (or opencode2 service restart for an existing service). Connect your provider, then select coordinate in the agent picker. The default configuration uses OpenAI GPT models; agents are only enabled when the required models are available.

Configure

See GPT configuration and custom model assignments. When using the installer, point the example's plugin package entry at the installed package directory rather than the unpublished npm package name. Configured local plugin paths must be directories; pointing at plugins/stanp-opencode.js causes OpenCode to reject that configured entry and auto-load the file without its options:

{
    "plugins": [
        {
            "package": "./plugins/stanp-opencode",
            "options": {
                "mode": "gpt",
                "provider": "openai",
                "lunaPriority": true,
            },
        },
    ],
}

This relative path assumes the configuration file is in the selected global config directory. Use an absolute path in project configuration. Remove any old V1 plugin entry when migrating; V2 uses plugins. lunaPriority requests priority service where supported and can increase cost; set it to false to use the provider default.

The plugin supplies session-local todoread and todowrite tools when no other plugin provides them. In this pinned V2 beta, custom tools cannot open permission prompts: an ask or deny rule blocks these todo tools rather than bypassing the rule. Explicitly allow them if you want to use them.

When an MCP server named codegraph is already configured, its tools are exposed directly to coordinate and retain the built-in build agent's matching allow, ask, and deny rules. The plugin does not configure or start a missing server, and no other MCP server is exposed this way.

Uninstall

Remove plugins/stanp-opencode from the selected config directory and remove any explicit configuration entry for it, then restart OpenCode.