Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.opencoven.ai/llms.txt

Use this file to discover all available pages before exploring further.

Install Coven, run coven doctor, and launch your first harness session in about five minutes. By the end you will have a running daemon, a project-rooted session record, and a working PTY attached to Codex or Claude Code.

​
What you need

  • Rust stable — only if you build from source. The published @opencoven/cli wrapper bundles binaries for macOS and Linux.
  • At least one harness CLI on PATH — Codex or Claude Code today. coven doctor will report what is missing and how to install it.
Coven does not store provider credentials. Each harness keeps using its own local auth flow (codex login, claude doctor).

​
Quick setup

1

Install Coven

npm install -g @opencoven/cli
Other install methods: Install.
2

Run doctor

coven doctor
doctor checks the store, project boundary, and harness readiness. Follow its hints before continuing.
3

Start the daemon

coven daemon start
coven daemon status
The daemon binds a Unix socket under $COVEN_HOME. Default: ~/.coven/coven.sock.
4

Launch your first session

cd /path/to/your/project
coven run codex "describe this repo"
Or open the human session browser:
coven sessions

​
What to do next

Sessions and rituals

Attach, archive, summon, sacrifice — the safe ways to manage live and finished work.

Familiars

Name your agents, give them roles, and let them remember.

Local API

Build a client that handshakes with GET /api/v1/health.