# Coven: Local-First Runtime for AI Coding Agent Sessions

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/opencoven-coven
Generated for open source discovery and AI-assisted research.

Coven is a powerful local-first runtime designed for managing project-scoped AI coding agent sessions. It provides durable state, robust authority boundaries, and seamless interoperability with multiple coding harnesses like Codex, Claude Code, and GitHub Copilot CLI. This tool enables developers to safely launch, observe, and coordinate AI agent work directly within their local project environments.

GitHub: https://github.com/OpenCoven/coven
OSRepos URL: https://osrepos.com/repo/opencoven-coven

## Summary

Coven is a powerful local-first runtime designed for managing project-scoped AI coding agent sessions. It provides durable state, robust authority boundaries, and seamless interoperability with multiple coding harnesses like Codex, Claude Code, and GitHub Copilot CLI. This tool enables developers to safely launch, observe, and coordinate AI agent work directly within their local project environments.

## Topics

- Rust
- AI Agents
- Developer Tools
- CLI
- Local-First
- Agent Orchestration
- Coding Agent
- AI Development

## Repository Information

Last analyzed by OSRepos: Fri Sep 18 2026 08:35:25 GMT+0100 (Western European Summer Time)
Detail views: 0
GitHub clicks: 0

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

Coven is a cutting-edge local-first runtime developed by OpenCoven, specifically engineered for project-scoped AI coding agent sessions. It acts as a neutral substrate, allowing developers to integrate and manage various coding agent CLIs, including Codex, Claude Code, and GitHub Copilot CLI, within explicit local project boundaries. Coven ensures durable state, establishes clear authority boundaries, and facilitates multi-harness interoperability, making it a pivotal tool for modern AI-assisted development workflows.

## Why Use Coven and Its Benefits

Coven addresses the need for a controlled and visible environment for AI coding agents. Its core philosophy is "One project. Any harness. Visible work." This means you gain unparalleled flexibility and control over your AI-driven development:

*   **Harness Flexibility**: Choose your preferred coding agent, whether it's Codex, Claude Code, GitHub Copilot CLI, or future adapters, and run them all through a unified system.
*   **Session Ownership**: Coven takes ownership of the agent session, providing project-scoped boundaries, secure PTY execution, comprehensive event logging, and SQLite persistence. This ensures that agent activities are contained, auditable, and their state is durable.
*   **Visible Work**: All agent interactions and outputs are made visible, allowing developers to observe, attach to, and coordinate agent work effectively.
*   **Security and Control**: The Rust daemon acts as the authority boundary, ensuring that security decisions flow inward, enhancing the safety of your development environment.
*   **Local-First Development**: By operating locally, Coven offers speed, privacy, and reliability, reducing dependency on external services for core agent operations.

## Installation

Getting started with Coven is straightforward using npm. Ensure you have Node.js installed, then run:

bash
npm install -g @opencoven/cli
coven doctor


Coven's universal wrapper (`@opencoven/cli`) automatically selects the correct platform-specific package for your system (macOS Apple Silicon, macOS Intel x64, glibc-based Linux x64, or Windows x64). For more detailed installation routes, including cargo and source builds, refer to the official [documentation](https://docs.opencoven.ai/docs/guide/install "Coven Installation Guide" target="_blank").

## Examples

Here's a quick guide to launching and managing your first AI coding agent session with Coven:

bash
cd /path/to/your/project

# 1. Complete provider-owned login
coven setup codex

# 2. Check local readiness
coven doctor

# 3. Start the daemon
coven daemon start

# 4. Launch a session
coven run codex "fix the failing tests"

# 5. Browse and manage sessions
coven sessions

# 6. Stop the daemon when done
coven daemon stop


Running `coven` without arguments opens the interactive Coven UI, providing a visual interface for managing your sessions. The full command reference is available in the [CLI documentation](https://docs.opencoven.ai/docs/cli "Coven CLI Reference" target="_blank").

## Links

*   **GitHub Repository**: [OpenCoven/coven](https://github.com/OpenCoven/coven "Coven GitHub Repository" target="_blank")
*   **Official Website**: [opencoven.ai](https://opencoven.ai/ "OpenCoven Official Website" target="_blank")
*   **Documentation**: [docs.opencoven.ai](https://docs.opencoven.ai/ "Coven Documentation" target="_blank")
*   **Discord Community**: [Join Discord](https://discord.gg/opencoven "Join the OpenCoven Discord" target="_blank")
*   **X (Twitter)**: [@OpenCvn](https://x.com/OpenCvn "OpenCoven on X" target="_blank")