Agent-Stack — OpenCode + OMO configuration reference docs

This repo is a settings dump — the actual redacted config files (opencode.jsonc, oh-my-openagent.jsonc) live here alongside the architectural documentation. The configs are the main content; the docs are QoL reference.

Setup overview

• Harness: OpenCode CLI v1.17.20 | Plugin: oh-my-openagent@latest (v4.19.0)
• Go subscription: OpenCode Go ($10/mo)
• Models: 3 families across 2 tiers (Go-tier paid pool + Zen free shared pool)
• Agents: 19 agent definitions, 9 categories, 2-tier routing, 14 with prompt_append
• Compaction: 3 layers (OpenCode auto-prune, OMO DCP hooks, DCP plugin nudges)
• Auto-Rules: 7 rule files in .opencode/rules/ auto-activate by path patterns covering Rust, Python, TypeScript/React, Config, Git, Go, and Agent behavior
• Context-mode: integrated ctx_* tooling for memory search, batch query, web indexing, and sandboxed execution
• Code viewer: VSCode for real-time code inspection alongside the agent

See docs/ARCHITECTURE.md for the full rationale and docs/CONFIG_MAP.md for the complete setting inventory.

Model tier cheat sheet

Tier	Model	Used by	Cost
Go	deepseek-v4-flash	Sisyphus, Plan, Worker, Review, Architect, Prometheus, Oracle, Hephaestus, Atlas, Test-Writer, Build	$10/mo shared pool
Free	deepseek-v4-flash-free	Sisyphus-Junior, Librarian, Metis, Momus, Writing, Git	$0 (rate-limited)
Free	mimo-v2.5-free	Explore, General, Scout, Multimodal-Looker	$0

Reasoning effort

Key agents with non-default reasoningEffort:

Agent	Effort
Sisyphus	max
Plan	max
Build	max
Writing	high
Atlas	low

Repository contents

Agent-Stack/
├── opencode.jsonc           ← redacted live config (settings dump)
├── oh-my-openagent.jsonc   ← redacted live config (settings dump)
├── README.md               ← this file
├── LICENSE                 ← MIT
├── .gitignore              ← explicit-ignore
├── .github/                 ← release tracker workflow
├── ADR/                    ← Architecture Decision Records (001–012)
├── docs/
│   ├── AGENTS.md             ← agent inventory, Go-tier vs Free-tier
│   ├── ARCHITECTURE.md       ← two-file split rationale + OMO merge model
│   ├── CONFIG_MAP.md         ← every config setting with value and rationale
│   ├── WORKFLOW.md           ← 9 process additions
│   ├── WORKFLOW_INTEGRATION.md ← combined Dev Protocol + start-work flow
│   ├── PRODUCTION_QUALITY.md ← OSS benchmark quality standards
│   ├── VERSIONS.md           ← tracked release versions for update checking
│   ├── INCIDENTS.md          ← platform incidents and mitigations
│   ├── TROUBLESHOOTING.md    ← common failure patterns
│   └── CHANGELOG.md          ← change history
├── research/
│   ├── COMMUNITY_CONFIGS.md             ← community config compilation
│   ├── GAP_RESEARCH.md                  ← identified gaps vs community
│   ├── INNOVATIONS_2026_H2.md           ← Agent harness innovations research
│   ├── 2026-07-18-landscape-refresh.md  ← Landscape refresh audit
│   └── SUPER_ANALYSIS.md                ← 16-dimension cross-config analysis
├── .opencode/rules/           ← 7 auto-rule .mdc files
└── scripts/
    ├── redact-config.sh      ← auto-redact live configs for publishing
    ├── regression-test.sh    ← 29 regression tests
    ├── cost-report.sh        ← session cost tracking
    ├── model-verifier.sh     ← model existence checker
    ├── post-agent-log.sh     ← audit logger
    ├── pre-commit-verify.sh  ← pre-commit validation
    ├── health-check.sh       ← system health check
    ├── verify.sh             ← unified suite runner
    └── check-updates.sh      ← release update tracker (GH Actions)

About the config files

The redacted configs are copies of ~/.config/opencode/opencode.jsonc and ~/.config/opencode/oh-my-openagent.jsonc with personal paths replaced by placeholders ({{OPENDATA_DIR}}, {{PLAYWRIGHT_CHROME}}). To generate your own, copy the files and replace placeholders with your actual paths.

Use scripts/redact-config.sh to update the redacted copies from your live configs.

System Dependencies

The config expects these global tools to be installed:

• Biome (@biomejs/biome) — LSP diagnostics for JSON, JSONC, JS, TS, CSS. Run npm i -g @biomejs/biome.
• Prettier — formatter for JS/TS/JSON/YAML/MD. Usually ships with Node.
• mcp-searxng — SearXNG MCP bridge. Installed globally via npm.
• Playwright — browser automation. Installed via playwright install chromium.

See scripts/health-check.sh for runtime dependency validation.

Companion

Development Protocol — Methodology governance layer: autonomy levels, execution discipline, scope calibration. Complements the config stack with how-to-work rules. WORKFLOW_INTEGRATION.md and PRODUCTION_QUALITY.md documentation lives in that repo.

Significant incidents

Date	Incident	Impact	Fix
Jul 3-4, 2026	Go platform #35149 — routing infrastructure broke	Go-tier models blocked with Insufficient Balance	opencode auth login + free-tier fallback
Jul 4, 2026	OMO v4.15.1 attribution injection	ithmb codec commits re-attributed	git hook stripping + config override
Jul 6, 2026	3.5GB DB bloat	Context slowing, WAL 339MB	WAL checkpoint, DB VACUUM deferred

See docs/INCIDENTS.md for full detail.

Repository Rules

This repo is the only directory in the agent-stack-workspace/ container pushed to GitHub. See the workspace root README for the full set of workspace-level rules.

Single-Commit Policy

This repo must always have exactly one commit. The commit preserves the latest commit's author and date. Squash flow:

# Capture latest commit metadata
AUTHOR="$(git log -1 --format='%an <%ae>')"
DATE="$(git log -1 --format='%aD')"
MSG="$(git log -1 --format='%s')"

git add -A
git reset --soft "$(git rev-list --max-parents=0 HEAD)"
git commit --amend --author="$AUTHOR" --date="$DATE" -m "$MSG"
git push --force-with-lease origin main

Mirroring Live Configs

We edit the global configs at ~/.config/opencode/, then mirror them here:

bash scripts/redact-config.sh

The script replaces personal paths with placeholders ({{OPENDATA_DIR}}, etc.) for safe publishing.

License

MIT — see LICENSE.