Install
Installation guide for Coven Code, including recommended npm install, the companion Coven daemon CLI, GitHub Releases archives, source builds, upgrades, and verification.
2 min read
Recommended Install
Install the Coven Code package:
npm install -g @opencoven/coven-codeThen open a new terminal and verify the command:
coven-code --version
coven-codeThis installs the coven-code binary and the coven-cave compatibility alias. You can also run it without a permanent install:
npx @opencoven/coven-codeThe Coven Daemon CLI
The bare coven command ships separately with @opencoven/cli, the Coven daemon CLI. When coven-code is on PATH, coven and coven tui exec into Coven Code automatically (opt out with COVEN_LEGACY_TUI=1):
npm install -g @opencoven/cli
coven --version
coven doctor
coven tuiInstall it when you want daemon workflows (coven daemon, coven sessions, /coven from the TUI); Coven Code itself does not require it.
Prefer one install channel per binary
Avoid keeping stale copies from several install paths on PATH. If which coven-code or where coven-code points somewhere unexpected, uninstall the old channel before debugging provider or daemon behavior.
Manual Release Archives
Prebuilt archives ship from OpenCoven/coven-code releases. Download the archive that matches your OS and CPU:
| Platform | Archive |
|---|---|
| Windows x86_64 | coven-code-windows-x86_64.zip |
| Linux x86_64 | coven-code-linux-x86_64.tar.gz |
| Linux aarch64 | coven-code-linux-aarch64.tar.gz |
| macOS Intel | coven-code-macos-x86_64.tar.gz |
| macOS Apple Silicon | coven-code-macos-aarch64.tar.gz |
Each archive contains coven-code or coven-code.exe. Put the binary somewhere on PATH, then run:
coven-code --versionOn macOS, a downloaded binary may keep a quarantine flag. If you trust the release you downloaded, clear it with:
xattr -rd com.apple.quarantine /path/to/coven-codeBuild From Source
Source builds require Rust and the repo checkout:
git clone https://github.com/OpenCoven/coven-code.git
cd coven-code/src-rust
cargo build --release --package claurstThe internal Rust crate names still use claurst-* for upstream merge compatibility. In short: the Rust workspace package is claurst, the installed binary it builds is coven-code, and the npm distribution is @opencoven/coven-code.
Upgrade
For the Coven Code package:
npm install -g @opencoven/coven-code@latestFor the Coven daemon CLI:
npm install -g @opencoven/cli@latestSettings under ~/.coven-code and daemon state under ~/.coven are preserved.
Verify The Install
Run:
coven-code --version
coven-code --provider codex --print "Say installed"
coven daemon statusThe first command verifies the binary. The second verifies a headless prompt path after provider setup. The third verifies the local Coven daemon if you plan to use /coven from the TUI.
If installation succeeds but launch fails, see Troubleshooting.
Last updated on