Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

OpenCoven/coven-code

Repository files navigation

Coven Code

Coven Code is an open-source, multi-provider agentic coding TUI built in Rust. It is maintained by OpenCoven as a GPL-3.0 fork of Claurst by Kuber Mehta.

Attribution: Coven Code is derived from Claurst v0.0.28 under the GNU General Public License v3.0. The full license is in LICENSE.md and upstream attribution is in ATTRIBUTION.md.


What it is

Multi-provider terminal coding agent with a rich ratatui TUI: chat forking, memory consolidation, diff viewer, plugin system, MCP support, session branching, and a mascot companion. No telemetry, no tracking.

Supported providers: Anthropic (Claude), OpenAI, Google (Gemini), Groq, Ollama, LM Studio, llama.cpp, OpenRouter, AWS Bedrock, Google Vertex, and any OpenAI-compatible endpoint.


Status

Beta (v0.0.28). Core agent, multi-provider routing, and TUI are stable for daily use. Experimental features are flagged below.

Recent highlights:

  • /share — share sessions via unlisted GitHub Gists [EXPERIMENTAL]
  • Free Mode — try /connect for a free-tier agentic coding experience [EXPERIMENTAL]
  • /goal/goal <objective> keeps the agent working across multiple turns [EXPERIMENTAL]
  • /coven — drive the local Coven daemon (sessions, harness runs, rituals) without leaving the TUI. /coven is the unified replacement for coven-cli's interactive menu and the legacy coven-tui slash shell; when coven-code is on PATH, coven and coven tui exec into it automatically (opt out with COVEN_LEGACY_TUI=1). Run /coven help for the subcommand list.

Getting Started

Quick install (Linux / macOS)

curl -fsSL https://github.com/OpenCoven/coven-code/releases/latest/download/install.sh | bash

Quick install (Windows PowerShell)

irm https://github.com/OpenCoven/coven-code/releases/latest/download/install.ps1 | iex

This drops coven-code into ~/.coven-code/bin (or %USERPROFILE%\.coven-code\bin on Windows) and adds it to your PATH. Open a new terminal and run coven-code.

npm / Bun

npm install -g coven-code
# or the scoped package
npm install -g @opencoven/coven-code
bun install -g coven-code
# or the scoped package
bun install -g @opencoven/coven-code
npx coven-code
bunx coven-code

Upgrade

coven-code upgrade

Pin a version: coven-code upgrade --version 0.1.0.


Manual install

Pre-built archives are on GitHub Releases:

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 a single coven-code (or coven-code.exe) binary.


Build from source

git clone https://github.com/OpenCoven/coven-code.git
cd coven-code/src-rust
cargo build --release --package claurst # binary outputs as coven-code

Internal Rust crate names (claurst-core, claurst-tui, etc.) are preserved from upstream for merge-friendliness. The compiled binary is named coven-code.


Configuration

Coven Code is a local CLI tool — it runs entirely on your machine. You bring your own API key for whichever provider you use. Nothing is sent to OpenCoven servers; all requests go directly from your terminal to the provider.

Settings live in ~/.coven-code/settings.json. Set your provider key in the environment or via /config:

export ANTHROPIC_API_KEY=<your-key>
coven-code

Or log in via OAuth after configuring a Coven Code OAuth client:

export COVEN_CODE_ANTHROPIC_OAUTH_CLIENT_ID=<registered-client-id>
coven-code auth login

Or use a local model with no key at all:

coven-code --provider ollama

Environment variable prefix: COVEN_CODE_* (e.g. COVEN_CODE_SKIP_PROMPT_HISTORY=1).


Providers

See docs/providers.md for the full provider reference.

Quick example:

coven-code --provider openai "refactor this module"
coven-code --provider ollama "explain this function"
coven-code --provider groq --model llama-3.3-70b-versatile "write tests"

Extensibility seams

Coven Code is designed to grow into the OpenCoven ecosystem. Key seams for future integration:

Surface Location Notes
Provider adapters src-rust/crates/api/src/providers/ Add new LlmProvider impls here
Plugin system src-rust/crates/plugins/ Runtime plugin loading
ACP server src-rust/crates/acp/ JSON-RPC 2.0 over stdio — OpenCoven adapter entry point
Command registry src-rust/crates/commands/ Add /slash commands
TUI theme src-rust/crates/tui/src/theme_colors.rs OpenCoven violet/pink palette is the default; deuteranopia variant ships too. Diff viewer routes through DiffPalette so colour-blind users see orange/blue diffs.
Memory / session src-rust/crates/core/src/memdir.rs, session_storage.rs Hook for Coven session/memory integration
Companion mascot src-rust/crates/tui/src/mascot.rs ASCII mascot renderer; seven archetypes ship (kitty, nova, cody, charm, sage, astra, echo). F2 opens the live switcher.
Coven daemon client src-rust/crates/core/src/coven_daemon.rs Typed DaemonClient over ~/.coven/coven.sock speaking coven.daemon.v1. Powers /coven + the welcome status block.

OpenCoven fork notes

  • Internal crate names (claurst-core, claurst-tui, etc.) are intentionally preserved from upstream to keep git merge upstream/main low-friction.
  • User-visible surfaces (binary, env vars, data dirs, ACP registry, docs) are fully rebranded to coven-code / COVEN_CODE_.
  • To sync upstream improvements: git fetch upstream && git merge upstream/main.
  • License: GPL-3.0. See LICENSE.md and ATTRIBUTION.md.

Links

AltStyle によって変換されたページ (->オリジナル) /