You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
**Coven Code** is an open-source, multi-provider agentic coding TUI built in Rust. It is maintained by [OpenCoven](https://opencoven.ai) as a GPL-3.0 fork of [Claurst](https://github.com/Kuberwastaken/claurst) by Kuber Mehta.
4
4
5
-
> **Attribution:** Coven Code is derived from Claurst v0.0.10 under the GNU General Public License v3.0. The full license is in [`LICENSE.md`](LICENSE.md) and upstream attribution is in [`ATTRIBUTION.md`](ATTRIBUTION.md).
5
+
> **Attribution:** Coven Code is derived from Claurst v0.0.11 under the GNU General Public License v3.0. The full license is in [`LICENSE.md`](LICENSE.md) and upstream attribution is in [`ATTRIBUTION.md`](ATTRIBUTION.md).
6
6
7
7
---
8
8
@@ -16,7 +16,7 @@ Multi-provider terminal coding agent with a rich ratatui TUI: chat forking, memo
16
16
17
17
## Status
18
18
19
-
> **Beta (v0.0.10).** Core agent, multi-provider routing, and TUI are stable for daily use. Experimental features are flagged below.
19
+
> **Beta (v0.0.11).** Core agent, multi-provider routing, and TUI are stable for daily use. Experimental features are flagged below.
20
20
21
21
Recent highlights:
22
22
-**/share** — share sessions via unlisted GitHub Gists `[EXPERIMENTAL]`
Copy file name to clipboardExpand all lines: docs/familiars.md
+44-46Lines changed: 44 additions & 46 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,19 +6,17 @@ Coven Code integrates natively with the Coven daemon's familiar roster. When the
6
6
7
7
## What is a familiar?
8
8
9
-
A familiar is a named AI persona defined in the Coven ecosystem. Each familiar has an identity (display name, emoji, pronouns), a role description, and optional metadata used to shape how the model presents itself and reasons about tasks. Familiars live under`~/.coven/familiars.toml` and are managed by the Coven daemon.
9
+
A familiar is a named AI persona defined in the Coven ecosystem. Each familiar has an identity (display name, emoji, pronouns), a role description, and optional metadata used to shape how the model presents itself and reasons about tasks. Familiars are user-defined and live in`~/.coven/familiars.toml`, managed by the Coven daemon.
10
10
11
-
Examples from the default Coven roster:
11
+
For example, a minimal Coven setup might have:
12
12
13
13
| ID | Name | Role |
14
14
|---|---|---|
15
-
|`nova`| Nova ✨ | Orchestrator, personal AI companion |
16
-
|`kitty`| Kitty 🐱 | General helper |
17
-
|`cody`| Cody 🤖 | Code-first agent |
18
-
|`sage`| Sage 🧙 | Research and reasoning |
19
-
|`astra`| Astra 🌙 | Strategy and planning |
20
-
|`echo`| Echo 👻 | Reflection and retrospection |
21
-
|`charm`| Charm 💜 | Writing and communication |
15
+
|`dev`| Dev 🤖 | Code-first implementation agent |
16
+
|`research`| Research 🧙 | Research and reasoning |
17
+
|`writer`| Writer ✍️ | Writing and communication |
18
+
19
+
You define your own familiars — the names, roles, and roster are entirely yours.
22
20
23
21
---
24
22
@@ -64,19 +62,19 @@ coven-code agents list
64
62
Output groups entries by type:
65
63
66
64
```
67
-
Available Agents (5)
65
+
Available Agents (4)
68
66
69
-
Workspace Agents (2)
67
+
Workspace Agents (1)
70
68
• review: Senior code reviewer...
71
69
Model: default
72
70
73
71
✨ Coven Familiars (3)
74
-
★ Nova [nova]
75
-
Your personal AI companion and orchestrator.
76
-
★ Sage [sage]
77
-
Research, reasoning, and synthesis.
78
-
★ Cody [cody]
79
-
Code-first implementation agent.
72
+
★ Dev [dev]
73
+
Fast, focused code implementation and review.
74
+
★ Research [research]
75
+
Deep research, synthesis, and structured thinking.
76
+
★ Writer [writer]
77
+
Clear writing, docs, and async communication.
80
78
81
79
Switch active familiar: coven-code agent <name>
82
80
```
@@ -90,30 +88,30 @@ coven-code agents familiars
90
88
### Inspect a specific familiar
91
89
92
90
```
93
-
coven-code agent nova
91
+
coven-code agent dev
94
92
```
95
93
96
94
Output:
97
95
98
96
```
99
-
✨ Activating familiar: Nova
100
-
Description: ✨ Orchestrator — Your personal AI companion and orchestrator.
You are ✨ Nova, a Coven familiar with the role of Orchestrator.
105
-
Your personal AI companion ...
102
+
You are 🤖 Dev, a Coven familiar with the role of Code Agent.
103
+
Fast, focused code implementation ...
106
104
107
105
Start a session to apply this persona:
108
-
coven-code --agent "Nova" [prompt]
106
+
coven-code --agent "Dev" [prompt]
109
107
```
110
108
111
109
### Start a session as a specific familiar
112
110
113
111
```
114
-
coven-code --agent "Nova" "refactor the auth module"
115
-
coven-code --agent "Sage" "what are the tradeoffs in our current DB schema?"
116
-
coven-code --agent "Cody" "add unit tests for packages/core"
112
+
coven-code --agent "Dev" "refactor the auth module"
113
+
coven-code --agent "Research" "what are the tradeoffs in our current DB schema?"
114
+
coven-code --agent "Writer" "write release notes for v1.2"
117
115
```
118
116
119
117
The familiar's persona is prepended to the system prompt. Everything else — tools, providers, turn budget — works as normal.
@@ -126,27 +124,27 @@ Familiars are defined in `~/.coven/familiars.toml`:
126
124
127
125
```toml
128
126
[[familiar]]
129
-
id = "nova"
130
-
display_name = "Nova"
131
-
emoji = "✨"
132
-
role = "Orchestrator"
133
-
description = "Your personal AI companion and trusted orchestrator."
134
-
pronouns = "she/her"
127
+
id = "dev"
128
+
display_name = "Dev"
129
+
emoji = "🤖"
130
+
role = "Code Agent"
131
+
description = "Fast, focused code implementation and review."
132
+
pronounces = "they/them"
135
133
136
134
[[familiar]]
137
-
id = "sage"
138
-
display_name = "Sage"
135
+
id = "research"
136
+
display_name = "Research"
139
137
emoji = "🧙"
140
138
role = "Research & Reasoning"
141
139
description = "Deep research, synthesis, and structured thinking."
142
140
143
141
[[familiar]]
144
-
id = "cody"
145
-
display_name = "Cody"
146
-
emoji = "🤖"
147
-
role = "Code Agent"
148
-
description = "Fast, focused code implementation and review."
149
-
pronouns = "he/him"
142
+
id = "writer"
143
+
display_name = "Writer"
144
+
emoji = "✍️"
145
+
role = "Writing & Communication"
146
+
description = "Clear writing, docs, and async communication."
147
+
pronounces = "she/her"
150
148
```
151
149
152
150
### Fields
@@ -164,18 +162,18 @@ pronouns = "he/him"
164
162
165
163
## Overriding a familiar with a workspace agent
166
164
167
-
To customise a familiar's behaviour for a specific project, create a `.coven-code/agents/<name>.md` file that matches the familiar's display name. Workspace agents take precedence over familiar-sourced definitions with the same name:
165
+
To customise a familiar's behaviour for a specific project, create a `.coven-code/agents/<id>.md` file that matches the familiar's display name. Workspace agents take precedence over familiar-sourced definitions with the same name:
168
166
169
167
```markdown
170
168
---
171
-
name: Nova
172
-
description: Nova customised for this monorepo
169
+
name: Dev
170
+
description: Dev customised for this monorepo
173
171
model: anthropic/claude-sonnet-4-6
174
172
---
175
173
176
-
You are Nova ✨, operating inside the OpenCoven monorepo.
177
-
Prioritise TypeScript/Rust consistency and follow the OpenCoven
178
-
design system for all UI-facing changes.
174
+
You are 🤖 Dev, operating inside the my-monorepo project.
175
+
Prioritise TypeScript consistency and follow the project's
176
+
contributing guide for all code changes.
179
177
```
180
178
181
179
The familiar-sourced entry will be suppressed; only the workspace definition appears.
Copy file name to clipboardExpand all lines: docs/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@
6
6
7
7
Coven Code is a high-performance Rust reimplementation of Claude Code — a terminal-native AI coding agent with streaming responses, 40+ built-in tools, 15+ LLM provider integrations, a full ratatui TUI, and an extensible plugin system.
0 commit comments