Files
stanp-opencode/README.md
T
StanPonomarev deaa4bfd07
CI / verify (pull_request) Successful in 10s
fix: fix configurations
2026-10-08 09:18:01 +02:00

54 lines
3.1 KiB
Markdown

# 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" },
],
}
```