opencode-configs

# OpenConfig Pinned global config for [OpenCode](https://opencode.ai) + [OpenRouter](https://openrouter.ai) + [oh-my-openagent (OmO)](https://omo.vibetip.help/docs). **v1.5.30** · CLI **`oc`** · identity `openconfig/opencode-configs` ```bash git clone https://github.com/jesseoue/opencode-configs.git cd opencode-configs oc install --quick # or: ./install.sh --yes # Fresh machine curl -fsSL https://raw.githubusercontent.com/jesseoue/opencode-configs/main/install.sh | bash source ~/.zshrc && oc doctor && oc launch ``` | | | | --- | --- | | **Pins** | OpenConfig `1.5.30` · OpenCode `1.18.4+` · OmO `oh-my-openagent@4.19.0` · `@opencode-ai/plugin` `1.18.4` | | **Default lead** | `sisyphus` (GLM Exacto) | | **Config path** | `~/.config/opencode` → this repo (symlink) | | **Projects home** | `oc new` → `~/Projects/<name>` | | **Health** | `oc doctor` · `oc versions` · `oc test` | > Plugin name must stay **`oh-my-openagent@…`** (not legacy `oh-my-opencode`). > Schema URL basename stays `oh-my-opencode.schema.json` (the `oh-my-openagent.schema.json` path 404s). Decision log: [`AGENTS.md`](./AGENTS.md) · Stance: [`prompts/core.md`](./prompts/core.md) · Changelog: [`CHANGELOG.md`](./CHANGELOG.md) --- ## Install ```bash export OPENROUTER_API_KEY=… # required export OPENAI_API_KEY=… # GPT lane (Hephaestus / Oracle / Momus / …) export EXA_API_KEY=… # OmO websearch export CONTEXT7_API_KEY=… # library docs oc install --quick oc signature && oc test && oc versions && oc doctor oc launch ``` Or edit keys after install: ```bash $EDITOR ~/.config/opencode/.env # chmod 600; never commit source ~/.zshrc oc doctor && oc launch ``` --- ## CLI ```bash oc install --quick # install / refresh oc check # validate + doctor --quick oc heal # probe-first self-repair oc launch [dir] # TUI (never starts in the config repo) oc new myapp # scaffold under ~/Projects oc run "…" # headless to completion oc admin health # live OpenRouter + OpenAI probes oc models --providers # OpenRouter provider health for routed models oc versions # pins vs npm + GitHub (+ other opencode.json) oc versions --fix # align ~/.opencode @opencode-ai/plugin to CLI oc locate # repo / CLI / keys oc signature # identity fingerprint oc test # smoke + idempotency oc doctor # full readiness oc doctor --quick --json # machine summary (heal/check tooling) ``` Prefer `oc <cmd>` over raw `./foo.sh`. Full help: `oc help`. --- ## Package pins Floors and the OmO pin live in [`versions.json`](./versions.json). The OmO plugin string in `opencode.json` must match. Audit anytime: ```bash oc versions # local pins + npm/GitHub latest oc versions --local # no network oc versions --json # machine-readable oc versions --fix # set ~/.opencode @opencode-ai/plugin to match OpenCode CLI ``` | Package | Source of truth | Current | | --- | --- | --- | | OpenConfig | `versions.json` → `opencode_configs` | `1.5.30` | | OpenCode CLI | install + `versions.json` → `opencode.min` | `1.18.4+` | | OmO | `opencode.json` plugin + `versions.json` → `oh_my_openagent.pin` | `4.19.0` | | `@opencode-ai/plugin` | `~/.opencode/package.json` (peer; not in this repo) | match CLI | `oc versions` also lists other `opencode.json` files under `~/Projects` and `/Users/Shared`. Those are project overlays — OmO stays pinned globally here. --- ## Tools | Need | Tool | Notes | | --- | --- | --- | | Local code | `read` · `grep` · `glob` · codegraph · LSP | Always first | | Library / framework APIs | **Context7** MCP | `resolve-library-id` → `query-docs` | | GitHub call sites | **grep_app** (OmO) | Public-repo patterns | | Current web | **websearch** (Exa) | Ideal-page queries; then webfetch | | Known URL | **webfetch** | Clean markdown | | Screenshots / UI | **look_at** (OmO) | multimodal-looker | **Exa:** describe the ideal page, not keyword soup. Optional: `category:company` · `category:people` · `category:news` · `category:research paper`. | Surface | Status | | --- | --- | | Context7 MCP | Enabled (`CONTEXT7_API_KEY`) | | Exa websearch | Enabled (`EXA_API_KEY`) | | codegraph | Enabled · telemetry off · `~/.omo/codegraph` | | LSP | TypeScript · Python · Go only | | Formatters | Prettier + Ruff | | Skills | `content-aware-recon` · `content-aware-audit` under `skills/` (fenced) | | OmO `security-*` skills | Disabled (hang headless `oc run`) — use local content-aware skills | | Extra MCPs | Disabled (PostHog, Sentry, Playwright MCP, …) | | Telemetry | Off (OpenCode share/OTel · OmO PostHog · codegraph · `DO_NOT_TRACK`) | Disabled on purpose (noisy / footguns): `interactive_bash`, monitor tools, `session_list` / `session_search`. Encoded in `prompts/core.md`, `sisyphus`, and `librarian`. --- ## Agents ### Primary | Agent | Model | Role | | --- | --- | --- | | **sisyphus** | GLM 5.2 Exacto | Default orchestrator / lead | | **hephaestus** | GPT-5.6 Sol (direct OpenAI) | Implementation | | **prometheus** | GLM 5.2 Exacto | Planner | | **atlas** | GLM 5.2 Exacto | Plan executor after `/start-work` | | **content-aware-research** | DeepSeek V4 Pro | Full-depth research (edit denied) | ### Subagents (`task` / `call_omo_agent` — not team members) | Agent | Model | Role | | --- | --- | --- | | oracle | GPT-5.6 Sol | Critique / adjudication | | librarian | DeepSeek Flash Nitro | Docs (Context7-first) | | explore | DeepSeek Flash Nitro | Codebase map | | multimodal-looker | Claude Sonnet 5 | Vision (`look_at`) | | metis | Claude Sonnet 5 | Pre-planning critic | | momus | GPT-5.6 Sol max | Plan / review gate | | sisyphus-junior | DeepSeek Flash Nitro | Cheap delegated work | Native OpenCode `build` is disabled. `plan` stays demoted for hyperplan handoff — do **not** put it in `disabled_agents`. --- ## Categories | Category | Model | Use | | --- | --- | --- | | `bug-hunt` | GLM Exacto | Reproduce → root cause → fix | | `refactor-safe` | GLM Exacto | Behavior-preserving refactors | | `arch-review` | GPT-5.6 Sol | Coupling / blast radius | | `content-aware-fast` | DeepSeek Flash Nitro | Attack-surface recon | | `content-aware-deep` | DeepSeek Pro Exacto | Deep vuln research | | `writing` | Gemini 3.6 Flash Nitro | Docs / prose | | `visual-engineering` | Gemini 3.1 Pro | Ship UI | | `artistry` | Gemini 3.1 Pro | Design direction | | `quick` | DeepSeek Flash Nitro | Cheap fast tasks | | `deep` / `ultrabrain` | GPT-5.6 Sol | Heavy / max reasoning | | `unspecified-low` / `unspecified-high` | Flash / Claude Fable | Hyperplan critics | --- ## Keywords & handoff | Say | Effect | | --- | --- | | `ultrawork` / `ulw` | Claude Fable max ceiling | | `team` | Team-mode expansion | | `hyperplan` / `hpp` / `/hyperplan` | Adversarial planning (from **sisyphus**) | | `/goal` | **Disabled** — OmO 4.19 goal hook breaks `/start-work`. Use `/start-work` → Atlas (`prompts/goal.md`) | | `/start-work` | Atlas executes an approved Prometheus plan | --- ## Teams Lead: **sisyphus**. Specs in `teams/` are **symlinked** to `~/.omo/teams/` by `oc setup`. Eligible: `sisyphus`, `atlas`, `sisyphus-junior`, `hephaestus` (`teammate: allow`), or `kind: category`. Hard-rejected as teammates: explore · librarian · oracle · metis · momus · multimodal · prometheus. Knobs: `max_parallel_members=4` · `max_members=5` · mailbox poll `1000ms` · tmux `main-vertical` / `inline`. | Team | Members (inline prompts: ROLE / DELIVERABLE / Mailbox) | | --- | --- | | `explorers` | scout-code (`deep`) + scout-docs (`quick`) | | `ship-feature` | forge (hephaestus) + junior + verifier (`bug-hunt`) | | `debug-team` | reproducer (`bug-hunt`) + root-cause (`ultrabrain`) | | `review-panel` | arch + bugs + cleanup (findings/proposals only) | | `refactor-team` | analyzer (`arch-review`) + executor (`refactor-safe`) | | `docs-team` | api-docs + guide (`writing`) | | `content-aware-audit` | recon (`content-aware-fast`) + deep (`content-aware-deep`) | --- ## Model routing | Lane | Models | Used for | | --- | --- | --- | | Orchestration | `z-ai/glm-5.2:exacto` | Sisyphus / Atlas / Prometheus / bug-hunt | | GPT (direct) | `openai/gpt-5.6-sol` (+ terra / 5.5 fallbacks) | Hephaestus / Oracle / Momus / deep | | Recon | `deepseek/deepseek-v4-flash:nitro` | explore / librarian / junior / quick | | Depth | `deepseek/deepseek-v4-pro:exacto` | content-aware / hard fallback | | Visual / writing | Gemini 3.1 Pro · 3.6 Flash Nitro | artistry / visual / writing | | Ceiling | `anthropic/claude-fable-5` | ultrawork · unspecified-high | OpenRouter is primary. GPT agents prefer **direct OpenAI**. Fallbacks + `runtime_fallback` on API errors. Stream timeouts: **900s**. ### Concurrency Priority: `modelConcurrency` → `providerConcurrency` → `defaultConcurrency`. `oc heal` / `fix.sh` re-apply caps if they drift. | Knob | Value | | --- | --- | | `background_task.defaultConcurrency` | **4** | | OpenRouter / OpenAI / Anthropic | **6 / 4 / 2** | | Flash / Exacto / Sol / Fable | **4 / 3 / 3 / 1** | | Team parallel / max members | **4 / 5** | | Goal / stale / TTL | **off / 180s / 30m** | --- ## API keys | Key | Required | Enables | | --- | --- | --- | | `OPENROUTER_API_KEY` | **yes** | OpenRouter models | | `OPENAI_API_KEY` | **yes** for GPT lane | Hephaestus / Oracle / Momus / deep / … | | `EXA_API_KEY` | for websearch | OmO Exa | | `CONTEXT7_API_KEY` | recommended | Context7 | | `OPENROUTER_MGMT_KEY` | optional | `oc admin` | | `OC_PROJECTS_DIR` | optional | `oc new` home (default `~/Projects`) | Copy `.env.example` → `.env` (`chmod 600`). Never commit `.env`. `oc setup --sync-env` imports **allowlisted keys only** from Infisical/Doppler — never a full vault dump. --- ## Prompts Every OmO agent/category loads a `prompt_append` from `prompts/`. Profiles under `prompts/profiles/` brief `oc new` scaffolds. | Path | What | | --- | --- | | `prompts/core.md` | Session-wide stance, tool matrix, team eligibility | | `prompts/goal.md` | Why `/goal` is off; use `/start-work` → Atlas | | `prompts/agents/*.md` | Agent appends | | `prompts/categories/*.md` | Category appends | | `prompts/profiles/*.md` | Profile briefs | | `agents/content-aware-research.md` | OpenCode primary-agent def (synced with prompts) | --- ## Profiles & scaffolding ```bash oc new myapp # ~/Projects/myapp · profile high oc new myapp --profile research oc new myapp --profile content-aware oc projects --list ``` | Profile | Agent | Tuning | | --- | --- | --- | | `high` | sisyphus | Default Exacto · balanced tool_output | | `low` | sisyphus | Cost-first · smaller tool_output | | `fast` | hephaestus | Direct GPT Sol · skip ceremony | | `research` | sisyphus | Large tool_output · deep / ultrabrain / content-aware | | `debug` | sisyphus | Large tool_output · bug-hunt / debug-team | | `writing` | sisyphus | Gemini Flash small_model · writing category | | `content-aware` | content-aware-research | Edit deny · Pro + recon/audit skills | Each project gets `opencode.json` + `AGENTS.md`. Do not set `OPENCODE_CONFIG` to `.opencode/profile.json`. --- ## Safety - Allow-everything locally for normal tools (trusted box). - Hard-deny bash: `rm -rf /|~`, `mkfs`, `sudo`, `git push --force*`, `gh repo delete*`. - Providers allowed: OpenRouter + OpenAI only. - Server: `127.0.0.1:4097` · share disabled · mdns off. --- ## Terminal - **Ghostty** ≥ 1.3.0 · **tmux** ≥ 3.3 (rec. 3.7+) · zsh snippet - OpenCode leader **Ctrl+X** · tmux prefix **Ctrl+B** · Tab cycles agents - Teardown never sends `\033[?1049l` (won’t wipe the visible screen) - `opencode()` / `oc launch` never start inside the config repo or bare `~/Projects` --- ## Layout ``` opencode-configs/ ├── oc · install.sh · setup.sh · doctor.sh · validate.sh · fix.sh ├── models.sh · versions.sh · cleanup.sh · signature.sh · locate.sh ├── opencode.json · oh-my-openagent.json · tui.json ├── versions.json · signature.json · projects.json · AGENTS.md ├── agents/content-aware-research.md ├── profiles/ · prompts/ · teams/ · skills/ ├── .env.example └── zshrc.snippet · ghostty.conf · tmux.conf ~/.config/opencode → this repo ~/Projects/ → oc new home ~/.omo/teams/ → team specs ~/.opencode-backups/→ backups + heal/install logs ``` --- ## Verify ```bash oc signature && oc test && oc validate && oc versions && oc doctor bunx oh-my-openagent@4.19.0 doctor # upstream: System OK ``` Idempotency: re-running install / setup / heal / fix on a healthy box must not clobber `.env`, rewrite correct symlinks, or bump clean config mtimes. --- ## Upstream | Layer | Docs | Source | | --- | --- | --- | | OpenCode | [opencode.ai/docs](https://opencode.ai/docs) | [anomalyco/opencode](https://github.com/anomalyco/opencode) | | OmO | [omo.vibetip.help/docs](https://omo.vibetip.help/docs) | [code-yeongyu/oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) | | OpenRouter | [openrouter.ai/docs](https://openrouter.ai/docs) | Exacto / Nitro routing | | Context7 | [context7.com](https://context7.com) | [upstash/context7](https://github.com/upstash/context7) | | Exa | [docs.exa.ai](https://docs.exa.ai) | [exa-labs](https://github.com/exa-labs) | Installer pulls OpenCode from `https://opencode.ai/install` and OmO from npm `oh-my-openagent@4.19.0` only. --- ## Anti-patterns - Don’t rename the plugin away from `oh-my-openagent` - Don’t add Cloudflare / AI Gateway / OpenAI-compatible shims - Don’t put `plan` in `disabled_agents` (breaks hyperplan) - Don’t commit `.env`, `package.json`, `node_modules`, `.omo`, `.sisyphus`, or `plugins/` here - Don’t scaffold apps into this repo — use `oc new` - Don’t load `.opencode/profile.json` as `OPENCODE_CONFIG` - Don’t re-enable telemetry or OmO `security-*` skills - Don’t re-enable `/goal` on OmO 4.19 until `/start-work` is safe --- ## Config-only scope **Keep:** - Prompt tweaks when a lane misbehaves - Local skills under `skills/` (fenced) — never re-enable OmO `security-*` - Weekly `oc models --providers` after OpenRouter host churn (don’t hand-edit `order`/`ignore` blindly) - `oc versions` after OpenCode / OmO releases (bump `versions.json` + plugin pin together) - Project scaffolds via `oc new` (apps stay outside this tree) **Skip:** - Extra MCP servers — keep `disabled_mcps` - Cloudflare AI Gateway / Claude Code bridge imports - Packaging as npm / shipping `node_modules` into the config dir - Turning this repo into an application