Overview
Coven Code overview for the agentic coding TUI, installed commands, provider boundary, local state, and daemon integration.
2 min read
Coven Code is OpenCoven's agentic coding TUI: a local terminal workspace for chatting with coding agents, reviewing file changes, switching providers, managing sessions, and driving the local Coven daemon without leaving the keyboard.
It is not a hosted service. The TUI runs on your machine, reads project context from your current working directory, and sends model requests directly to the provider you connect. Provider credentials stay in the provider or local Coven Code auth store, while Coven daemon operations still go through the same authority boundary documented in daemon security.
Name and command shape
The product name is Coven Code and the binary is coven-code, installed from the @opencoven/coven-code npm package along with the coven-cave alias. The bare coven command belongs to the separate Coven daemon CLI (@opencoven/cli), which execs into Coven Code for coven and coven tui when coven-code is on PATH.
When To Use Coven Code
Use Coven Code when you want an interactive coding agent in a terminal:
- Launch a project-scoped TUI with
coven tuiorcoven-code. - Connect Anthropic or Codex credentials from
/connect. - Change models and reasoning effort from
/model. - Use
/covento inspect local Coven sessions and harness runs. - Run headless one-shot prompts with
coven-code --print.
If you only need daemon lifecycle commands, start with the CLI Reference. If you are integrating raw Codex or Claude Code harnesses through the daemon, read Harnesses.
Installed Commands
Two npm packages cooperate here:
| Command | Ships with | Purpose |
|---|---|---|
coven-code | @opencoven/coven-code | The Coven Code binary. Use it directly for provider, model, and print-mode flags. |
coven-cave | @opencoven/coven-code | Compatibility alias for the same binary. |
coven | @opencoven/cli | Main Coven daemon CLI. When coven-code is on PATH, interactive entry execs into Coven Code (opt out with COVEN_LEGACY_TUI=1). |
coven tui | @opencoven/cli | Open the Coven Code TUI from the Coven command namespace. |
Local State
Coven Code owns ~/.coven-code for its settings, provider account records, sessions, prompts, plugins, keybindings, and TUI-specific state. The Coven daemon owns ~/.coven by default, including ~/.coven/coven.sock and the session ledger used by daemon clients.
Those directories are related but not interchangeable:
- Delete
~/.coven-codeonly when you want to reset Coven Code's TUI and account state. - Delete
~/.covenonly when you intend to erase local Coven daemon state shared by CLI, Cave, and other clients. - If you set
COVEN_HOME, make sure daemon-aware workflows and/covenpoint to the same Coven home.
Core Pages
Install Coven Code
Install through @opencoven/coven-code, download archives, or build from source.
Providers
Connect Anthropic and Codex, import Claude CLI credentials, and choose models.
Commands
Use CLI flags and in-session slash commands for coding workflows.
Configuration
Understand settings, environment variables, state directories, and daemon integration.
Last updated on