<p align="center" <img src="assets/opencoven/opencoven.svg" alt="OpenCoven logo" width="128" height="128" </p
Coven
Local harness substrate for project-scoped agent sessions
Run Codex, Claude Code, GitHub Copilot CLI, and future coding harnesses inside explicit local project boundaries. Launch, observe, attach, and coordinate agent work through one neutral runtime substrate.
| 🌐 Ecosystem | 💬 Community | 🛠️ Development | | :---------------------------------------------------- | :------------------------------------------ | :------------------------------------------------------------- | | Website | Discord | GitHub Issues | | Documentation | X (\@OpenCvn) | Public Roadmap | | Submit Feedback | | Contributing |
---
⚠️ Early MVP — Coven is a local-first runtime in active development. It is usable by adventurous developers on macOS, Linux, and Windows x64. The npm package is live. Expect rough edges. External PRs are open — Start from an issue for larger changes, keep PRs scoped, and include the readiness packet requested by the PR template.
---
What is Coven?
Coven is the local harness substrate for the OpenCoven ecosystem. It gives coding-agent CLIs like Codex and Claude Code a shared room where project work can happen visibly and safely.
One project. Any harness. Visible work.
- You choose the harness — Codex, Claude Code, GitHub Copilot CLI, or future adapters.
- Coven owns the session — project-scoped boundaries, PTY execution, event logging, SQLite persistence.
- Clients present the work — CastCodes, the CLI/TUI, comux, or your own integration over the same-user local IPC API.
The Rust daemon is the authority boundary. All clients — including the CLI itself — are convenience layers. Security decisions flow inward to the daemon, never outward to clients. OpenClaw integrates only through the opt-in @opencoven/coven plugin in packages/openclaw-coven; OpenClaw core contains no Coven code.
---
Install
npm install -g @opencoven/cli
coven doctor| Package | Platform | | -------------------------- | ---------------------------------------------- | | @opencoven/cli | Universal wrapper — auto-selects your platform | | @opencoven/cli-macos | macOS Apple Silicon | | @opencoven/cli-macos-x64 | macOS Intel x64 | | @opencoven/cli-linux-x64 | glibc-based Linux x64 (Alpine unsupported) | | @opencoven/cli-windows | Windows x64 |
The memory dashboard is an opt-in companion installed separately with npm install -g @opencoven/coven-memory-dashboard (Node.js 24+); see docs/reference/cli-observe.md.