# stanp-opencode

## Release installation

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

```sh
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](https://gist.github.com/VictorTaelin/91837951a5ce5b38f341ec1ba1df6449). 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:

```sh
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`.

```jsonc
{
    "$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" },
    ],
}
```