stanp-opencode/README.md

stanp-opencode

Release installation

Requires OpenCode 2.0.22, Bun 1.4.2+, Bash, curl, jq, and sha256sum on Linux/WSL.

curl -fsSL https://git.krtss.de/StanPonomarev/stanp-opencode/raw/branch/main/install.sh | bash -s -- --plugins agents,multi-work,quota,optchat

Choose any plugin subset; Multi-work requires Agents first.

Quota shows ChatGPT limits for the connected OpenAI account and, when Claude Code is logged in, Claude subscription limits read from ${CLAUDE_CONFIG_DIR:-~/.claude}/.credentials.json (read-only; Claude Code refreshes the token).

Optchat implements VictorTaelin's optchat recipe. It is off by default; run /optchat on, /optchat off, or /optchat status in a root session. In an enabled session, each turn sees a constant-size view of the whole chat, made of one-line summaries, plus the new message. The model can open any line with the zoom tool and read message times with date. Optchat does not apply to subagent sessions. Memory is stored in ~/.local/share/opencode/optchat/<sessionID>/. Compactions run in a child session named "optchat compactions". Optchat activates only when the compactionModel option is set, in the format provider/model[#variant] (for example opencode/claude-haiku-5-5#xhigh); without it (or when empty) the plugin registers nothing. A non-empty dataDir overrides the memory location. The installer writes both options as empty strings for you to fill in.

Local installation

From a local checkout, run:

bash /path/to/stanp-opencode/install-local.sh --plugins agents,multi-work,quota
opencode service restart

Configuration

Agents registers nothing until its agents option is set. The installer writes every missing option with an empty value ("") for you to fill in; an empty value means unset, so a fresh install stays inert. Each assignment is provider/model[#variant]; the variant selects the model's reasoning variant, falling back to a reasoningEffort request setting when the model does not advertise it. Merge this into ~/.config/opencode/opencode.json, preserving unrelated settings and plugins; update existing plugin entries instead of appending duplicates. The deep-lo and deep-hi assignments are optional as a pair; if either is omitted, both deep workers are disabled and orchestration uses good-lo.

{
    "$schema": "https://opencode.ai/config.json",
    // Required at the root and in worktrees.
    "experimental": { "subagent_depth": 2 },
    "plugins": [
        {
            "package": "./plugins/stanp-opencode/agents",
            "options": {
                "agents": {
                    "fast-lo": "openai/gpt-6-luna#low",
                    "fast-hi": "openai/gpt-6-luna#high",
                    "good-lo": "openai/gpt-6.1-sol#low",
                    "good-hi": "openai/gpt-6.1-sol#high",
                    "deep-lo": "openai/gpt-6-astra#low",
                    "deep-hi": "openai/gpt-6-astra#high",
                },
            },
        },
        { "package": "./plugins/stanp-opencode/multi-work" },
        { "package": "./plugins/stanp-opencode/quota" },
    ],
}