Content
# OpenCode Prime (OCP)
<div align="center">
**Production-ready multi-agent engineering for [OpenCode](https://opencode.ai).**
[](https://github.com/kenlin8827/opencode-prime/releases)
[](https://opencode.ai)
**[Documentation](https://opencode-prime.dev/)** · **[Releases](https://github.com/kenlin8827/opencode-prime/releases)** · **[中文](README.zh-CN.md)**
<br />
<img src="./docs/public/images/ocp-ui-tour-en.gif" alt="OpenCode Prime UI tour: dashboard, project wizard, terminal, web, and desktop interfaces" width="820" />
</div>
## Features
- **Specialist agent team:** 21 focused agents for frontend, Java, databases, security, QA, DevOps, and more.
- **Engineering guardrails:** Optional ADR, secret-file, and commit-discipline gates keep delivery predictable; `/e2e-adopt` scaffolds an E2E red-line policy into project docs.
- **Layered intelligence:** Configure CodeGraph, GitNexus, Serena LSP, DBHub, and other MCP services from one dashboard.
- **Model governance:** Map agents to `flash`, `standard`, `pro`, `max`, and `vision` tiers, then switch profiles in one action.
- **Guided setup:** Use the TUI wizard to configure providers, profiles, project knowledge, and guardrails without hand-editing files.
- **One configuration, five client modes:** The terminal TUI offers three selectable modes — Direct (`ocp`), Herdr (`ocp tui`), and Luvus (`ocp tui`) — alongside the OpenChamber VS Code extension (`ocp code`), web UI (`ocp web`), and native desktop app (`ocp desktop`).
- **Safe lifecycle commands:** Install, upgrade, update, inspect, and uninstall the suite while preserving local configuration.
## Install
```bash
# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/kenlin8827/opencode-prime/main/install.sh | bash
```
```powershell
# Windows PowerShell
irm https://raw.githubusercontent.com/kenlin8827/opencode-prime/main/install.ps1 | iex
```
Re-run the installer to upgrade while retaining API keys, custom models, and tier mappings. OCP **2.x requires the OpenCode v2 runtime** (major ≥ 2.0.0) — the installer resolves and pins the newest v2 release for you. For prerequisites, pinned versions, offline inspection, and clone-based installation, see the [installation guide](https://opencode-prime.dev/).
> **Upgrading from OCP 0.x?** OCP 2.0.0 is a fresh version line adapted to the OpenCode v2 runtime (native v2 plugin API, V2-native config keys, global `cli.json` for the terminal client). Cross-major installs are locked by design: back up with `ocp init`, then run the one-liner above. See the [release notes](install/versions/2.0.0.notes.md) and the migration ADR (ADR-2.0.0) for details.
## Quick start
```bash
ocp # launch the OpenCode terminal UI directly
ocp tui # launch the OpenCode terminal UI through the selected workspace wrapper
ocp wizard # configure OCP interactively
ocp dashboard # manage MCPs, plugins, and model tiers
ocp provider # configure model providers
ocp profile # select or manage a model-tier profile
ocp project # configure and initialize the current project
ocp usage # inspect token and cost usage across projects
ocp web # launch the OpenChamber web UI
ocp desktop # launch the native desktop app
ocp code # open VS Code with the OpenChamber extension ensured
ocp update # check and apply available updates
```
Run `ocp help` for all commands. The [CLI reference](https://opencode-prime.dev/maintenance/ocp-cli) covers aliases, arguments, upgrade behavior, and maintenance operations.
## Documentation
Read the [online documentation](https://opencode-prime.dev/) for agent roles, workflows, profiles, MCP servers, guardrails, installer options, and development guidance. Repository contributors should start with [DEVELOPING.md](DEVELOPING.md).
## License
Copyright (C) 2026 Ken Lin — licensed under the [GNU Affero General Public License v3.0 or later](LICENSE). Third-party integrations retain their own licenses.
