Quick Install & Dashboard

A production-ready OpenCode configuration for real-world software engineering: a team of specialist agents behind three orchestrator modes, layered MCP code intelligence and database gateway, one-shot model profiles, workflow slash commands, and optional per-project guardrails — installed into ~/.config/opencode with a single command.

---

⚡ 10-Second Quick Install

Install directly to ~/.config/opencode with a single command (no Git clone required):

macOS / Linux / WSL

rm -f /tmp/ocp.tar.gz && rm -rf /tmp/opencode-prime-* && curl -fsSL https://github.com/kenlin8827/opencode-prime/releases/latest/download/opencode-prime-latest.tar.gz -o /tmp/ocp.tar.gz && tar xzf /tmp/ocp.tar.gz -C /tmp && bash /tmp/opencode-prime-*/install/install.sh; rm -f /tmp/ocp.tar.gz; rm -rf /tmp/opencode-prime-*

Windows (PowerShell)

$url = "https://github.com/kenlin8827/opencode-prime/releases/latest/download/opencode-prime-latest.zip"; Remove-Item -Path "$env:TEMP\ocp.zip","$env:TEMP\ocp" -Recurse -Force -ErrorAction SilentlyContinue; Invoke-WebRequest -Uri $url -OutFile "$env:TEMP\ocp.zip"; Expand-Archive -Path "$env:TEMP\ocp.zip" -DestinationPath "$env:TEMP\ocp" -Force; & (Get-ChildItem "$env:TEMP\ocp\opencode-prime-*\install\install.ps1").FullName; Remove-Item -Path "$env:TEMP\ocp.zip","$env:TEMP\ocp" -Recurse -Force -ErrorAction SilentlyContinue

💡 Zero-Risk Upgrades: Re-running the command above smoothly upgrades to the latest release while preserving all your API keys, custom models, and tier assignments.

---

Single-Screen TUI Control Center

Running the install command (or running the global command ocp / opencode-prime anytime later) directly opens the Single-Screen TUI Control Center:

Key Capabilities & Keyboard Shortcuts

• Instant Customization: Press Space to toggle MCP servers, plugins, RTK optimizer, or cycle Agent-to-Tier model assignments (flash / standard / pro / max / vision);
• Keyboard Navigation:
  • ↑ / ↓ or j / k: Navigate through rows
  • Space: Toggle MCP/plugin or cycle agent model tier
  • Enter: Execute the selected action (e.g. "Save & Execute Install")
  • L key: Instant language switch (English / 中文)
  • Q key: Exit dashboard

---

Open Dashboard Anytime (ocp / opencode-prime)

After installation, the global shortcuts are automatically registered. You can run any of them from any terminal directory:

ocp              # 3-letter quick direct access (recommended)
opencode-prime   # Official full suite command
opencode-config  # Backward-compatible alias

You can now adjust settings or perform one-click seamless upgrades anytime without worrying about install paths!

---

Core Feature Matrix

Feature	What it means for you
Specialist Agent Team	21 specialists (@java-dev, @security, @dba, @frontend-dev, @fast-coder, etc.) tuned with domain-specific prompts, routed automatically
Three Working Modes	@code (direct development, default), @build (orchestrated execution), @plan (read-only analysis) — switchable in install/options.jsonc
Code Intelligence & DB (MCP)	Pre-configured MCP servers (Serena LSP, CodeGraph knowledge graph, GitNexus, DBHub gateway) with automatic CLI provisioning
Profiles	/profile maps all 5 model tiers to a provider's models in one shot — no per-agent set model
Workflow Slash Commands	/quick-dev · /fast-dev · /deep-dev · /ultra-dev dev loops, /review-fix-loop, /grill-improve-loop, /goal, /handoff, /grill-me, /advisor modes, and more
Optional Guardrails	Per-project ADR enforcement (/adr-guard), secret-file gate (env-guard), E2E gate (/e2e-guard), commit discipline (/project) — all default off
One-Command Installer	PowerShell + Bash, manifest-based upgrades; your credentials and model picks survive every reinstall
Token Savings	rtk output compression (60–90%) auto-provisioned on install
Second-Opinion Advisor	@advisor for blocking decisions, with an adversarial red-team stance for design review

---

⚖️ Positioning: omp vs OpenCode Prime

Two kinds of batteries, two kinds of rides. omp builds and ships its own native runtime; OCP loads engineering-discipline batteries into the OpenCode you already run.

Dimension	omp (omp.sh)	OpenCode Prime (OCP)
Relationship to Runtime	Standalone harness — replaces your agent runtime	⚡ Zero-migration discipline layer — keep your OpenCode runtime, plugins & config
What's in the Box	🔧 Native tooling firepower: ~80k-line Rust core, hashline edits, built-in LSP/DAP, memory, browser, collab	🧰 Discipline firepower: 21 specialist agents, MCP code intelligence, /profile presets, guardrails, workflow commands
Delivery Pacing	Magic keywords (ultrathink / orchestrate), single-track autonomy	🏆 /quick-dev · /fast-dev · /deep-dev · /ultra-dev — explicit human-selected tiers, SOP-friendly
Scheduling & Orchestration	🟢 task fan-out into isolated worktrees, typed results, live subagent hub	🏆 @build orchestrator + predefined role pipelines (plan visible before execution) + tiered scheduling (Flash codes, Flagship reviews) + dynamic domain-persona injection + auto-retry with task resume
Review Gates	/review post-hoc P0–P3 verdict, single reviewer	🏆 /deep-dev dual flagship review + @advisor safety arbitration — fixes converge inside the loop
Spec-Driven Lifecycle	None built-in (requires external tools)	🏆 /prd → /plan (auto-links PRD & ADRs) → /impl → /sdd handoff — full SDD lifecycle
Workflow Command Suite	ultrathink / orchestrate / workflowz keywords	🏆 /grill-me Socratic plan interrogation + /review-fix-loop auto-fix until zero P0/P1 + /grill-improve-loop score-driven improvement loop + /goal mechanically-checkable stop conditions + /handoff git-safe session bundles
Token & Cost Governance	hashline edit savings + efficient in-process tools	🏆 Five-tier agent-to-model routing (tiers.json) + RTK proxy-layer output compression (60–90%) auto-provisioned at install
Guardrails	Stream rules course-correct model behavior mid-stream	🏆 Auditable policy gates: ADR/MADR enforcement + secret-file gate + E2E gate + commit discipline
Code Intelligence	🟢 Built-in LSP/DAP/AST (14 LSP + 28 DAP ops)	Serena LSP + CodeGraph call graphs + GitNexus + DBHub database gateway
Provider Governance	60+ providers, role-based routing	🏆 /profile one-shot five-tier mapping — 36 presets covering the entire OpenCode built-in model family (opencode-go) plus Anthropic / OpenAI / Google / DeepSeek, routers, and first-class Chinese coding plans; TUI dashboard
Upgrade Safety	Binary reinstall	🏆 Manifest-based zero-risk upgrade — keys & model picks preserved across every reinstall
Documentation	English	🏆 Full bilingual docs tree (English + Chinese)
Ecosystem & Extensibility	🟢 TS extension modules, plugin hot-reload, inherits 8 existing config formats	🏆 Rides the OpenCode ecosystem — the whole npm plugin registry, MCP ecosystem, and community assets are directly reusable; OCP itself is 30+ composable plugins
Client / UI Surfaces	Terminal TUI + Zed (ACP) + collab viewer	🏆 TUI + browser Web UI + OpenChamber desktop GUI (side-by-side diff, multi-model comparison) — one config shared across all surfaces, zero re-setup

🎯 Which one fits you?

• Choose omp.sh: When you want a batteries-included native harness and are fine replacing your runtime — its Rust tooling, hashline edits, and DAP debugging are genuinely excellent.
• Choose OpenCode Prime: When you build real-world commercial software on OpenCode and want explicit delivery tiers, multi-model review gates, auditable policy guardrails, and Chinese-provider governance — without leaving the ecosystem you've already invested in.
• Coexistence is fine: omp as a standalone power tool, OCP as team discipline inside your OpenCode stack.

---

Next Step: Project Initialization

After installing the global configuration, the recommended first step whenever entering a specific code repository is running /project init:

👉 Read Guide: Project Initialization & Guardrails