---
title: "jesseoue/opencode-configs: OpenConfig — best OpenCode + oh-my-openagent (OmO) + OpenRouter AI coding"
url: https://stacklist.com/card/0feb2693-b144-460c-a465-4b923fe85618
source_url: "https://github.com/jesseoue/opencode-configs"
stack: https://stacklist.com/c/technology/stack/cc483fc9-ce97-46ea-bc49-7a300af7cd39
summary: "OpenConfig is a pinned global configuration repository for OpenCode, OpenRouter, and oh-my-openagent (OmO) that provides CLI tools and setup instructions for AI-assisted coding workflows. It includes installation procedures, API key configuration, version management, and diagnostic commands for maintaining a development environment."
tags: "opencode, configuration, ai-coding, openrouter, cli-tools, development-setup"
key_entities: "OpenCode (technology), OpenRouter (technology), oh-my-openagent (OmO) (technology), OpenAI API (technology), Exa (technology), Context7 MCP (technology), jesseoue (person), TypeScript (technology), Python (technology), Go (technology)"
classification: "reference"
content_hash: "sha256:3c93da93bc5bd596c3f0410cf3036457afc9461613f7e4deceb992e26d5d3a1d"
acp_version: "0.2"
token_counts_approximate: 3028
visibility: public
agent_accessible: true
status: "final"
---

# jesseoue/opencode-configs: OpenConfig — best OpenCode + oh-my-openagent (OmO) + OpenRouter AI coding

OpenConfig Pinned global config for OpenCode + OpenRouter + oh-my-openagent (OmO) . v1.5.38 · CLI oc · identity openconfig/opencode-configs 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.38 · OpenCode 1.18.5+ · OmO oh-my-openagent@4.19.1 · @opencode-ai/plugin 1.18.5 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 · Stance: prompts/core.md · Changelog: CHANGELOG.md Install 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: $EDITOR ~ /.config/opencode/.env # chmod 600; never commit source ~ /.zshrc oc doctor && oc launch CLI 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 plugin doctor # OmO pin-cache doctor (also: oc plugin --fix) 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 . The OmO plugin string in opencode.json must match. Audit anytime: 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.38 OpenCode CLI install + versions.json → opencode.min 1.18.5+ OmO opencode.json plugin + versions.json → oh_my_openagent.pin 4.19.1 @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-looker · 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 ( content-aware-fast ) + scout-docs ( quick ) ship-feature forge (hephaestus) + junior + verifier ( bug-hunt ) debug-team reproducer ( bug-hunt ) + root-cause ( content-aware-deep ) review-panel arch ( content-aware-deep ) + bugs ( bug-hunt ) + cleanup ( refactor-safe ) 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 / sisyphus-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 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 oc signature && oc test && oc validate && oc versions && oc doctor bunx oh-my-openagent@4.19.1 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 anomalyco/opencode OmO omo.vibetip.help/docs code-yeongyu/oh-my-openagent OpenRouter openrouter.ai/docs Exacto / Nitro routing Context7 context7.com upstash/context7 Exa docs.exa.ai exa-labs Installer pulls OpenCode from https://opencode.ai/install and OmO from npm oh-my-openagent@4.19.1 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