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.

Claude Code is Anthropic’s coding-agent CLI. Coven wraps it in a project-rooted PTY so launches, attaches, and rituals work the same as for any other harness.
FieldValue
Harness idclaude
Installnpm install -g @anthropic-ai/claude-code
Authclaude doctor (one-time, Anthropic side)
Doctor checkcoven doctor reports the resolved Claude path and version.

​
Setup

1

Install Claude Code

npm install -g @anthropic-ai/claude-code
2

Run Claude's own doctor

claude doctor
Provider credentials stay with Claude Code. Coven never reads them.
3

Confirm with Coven

coven doctor
The output should include claude: ok (/usr/local/bin/claude).
4

Launch

coven run claude "polish this UI"

​
Per-session flags

coven run claude "refactor for clarity" --cwd packages/web --title "Web refactor"
  • --cwd — canonicalized inside the project root.
  • --title — sets a readable title in the session browser.
  • --json — print structured launch metadata for clients.

​
Provider auth boundary

Claude Code owns its own OAuth flow and token cache. Coven never reads Anthropic keys or session cookies.

​
Troubleshooting

SymptomLikely causeFix
coven doctor reports claude missingClaude Code not on PATHnpm install -g @anthropic-ai/claude-code, then re-run doctor.
Claude prompts for loginAuth not finishedclaude doctor.
Session shows long pre-flight pauseClaude resolving configFirst run only; subsequent launches are fast.