← Back to home

The layer your agents share.

Coven sits between the agent CLIs you already run and the project they are working in. Your harness keeps reasoning and writing code. Coven holds the state those sessions have to share: intent, ownership, authority, and evidence.

Three layers, one boundary

Commands go down. Output and memory come back up. 
Coven attributes every crossing to a session.

Harness layer Claude CodeCodexHermesOpenCodeOpenClawwhatever ships next
commands down
Coven runtime SessionsMemoryAdapterTool gateway
output and memory up
Your project FilesystemGitTerminalsDocs
Boundary Every session works inside one project root. Anything out of tree needs a written grant.

What Coven keeps

Memory, sessions, harnesses, and actions. These four decide what a session can do.

01 · Memory

Memory that carries between sessions

A file on your disk. The next session reads it first.

~/.coven/familiars/hexi/memory.md
Project opencoven, Astro, no build step
Habit keep PR summaries short
Left off feat/runtime-attach, 4 files staged
Rule ask before touching infra/
02 · Sessions

A session outlives its terminal

Reboot mid-task and the record comes back. The process does not.

hexi · claude code live
harness
process
record
running
connection lost
terminated
rebooting
resuming
03 · Harnesses

One adapter contract

One harness can write files and another can use tools.
Coven interacts with both through one interface.

Claude Code
Anthropic · 12 sessions
Codex
OpenAI · last used 2h ago
Hermes Agent
Nous Research · next release
OpenClaw
Community · next release
Grok Build
xAI · next release
Yours
Open spec, one file
Claude Code
Anthropic · 12 sessions
Codex
OpenAI · last used 2h ago
Hermes Agent
Nous Research · next release
OpenClaw
Community · next release
Grok Build
xAI · next release
Yours
Open spec, one file
04 · Actions

Every agent asks first

Before an agent changes a file, runs a command, or pushes code, it asks Coven. 
Coven looks at who is working where and what you allowed, then gives one of three answers.

edit composer-shell.tsx
Hexi owns this file right now.
Yes
git push --force origin main
You said main is off limits.
No
terraform apply infra/
This one deletes things, so you decide.
Asks you

How a familiar learns a repo

Each familiar writes it's own notes and reads them back at the start of the next section.

day 001

Summoned Hexi. It read the repo and wrote nine notes.

Stack, entry points, the test command that works.

claude code · session 1 · notes created
day 009

Picked up how you review.

Terse PR summaries, no trailing recap. It stopped writing them.

claude code · sessions 2 to 6
day 023

Shipped feat/runtime-attach across three sessions.

Two of them started after a reboot.

codex claude code switched to codex mid-branch · same notes file
day 047

Still remembers all of it.

128 notes. You have read maybe six.

claude code codex hermes openclaw 41 sessions · 4 harnesses · 1 project record

Every agent already has its own worktree.
It did not help.

Two sessions, isolated checkouts, both right about their own context. Each diff was clean on its own, so git raised nothing and CI passed a tree that had already lost work.

WORKTREE ONLY
00m Hexi rewrites the session hook · 12m Sage rewrites the same hook · 18m
COVEN
00m Hexi claims the hook, edits it Sage holds reads Hexi's record, edits after · both land

One runtime. Every project. Any harness.

The Coven daemon is per machine. Claims, guards, and events are per project. Pick a project to see who is in it, and open any column for the detail behind it.

~/dev/opencoven
4 sessions
Projects
FamiliarSurfaceSessionDiff
Hexi
claude code
ui/composer
working reading composer-shell.tsx
0 0
Sage
codex
ui/composer
working opening composer-shell.tsx
no diff yet
Charm
claude code
api/auth
working adding refresh rotation
0 0
Mote
codex
infra/
bounded reading terraform plan
held
Hexi
claude code
src/shell
working reading window-chrome.tsx
+51 −9
Mote
codex
src/pty
working attaching to the pty
+18 −4
Charm
claude code
api/auth
working porting the login flow
+96 −31
Hexi
claude code
docs/guides
working rewriting the claims guide
+74 −22
Sage
codex
docs/reference
working generating the CLI reference
+118 −9
Overlap Hexi and Sage both hold ui/composer. Neither has merged yet.
Hexi familiar
Hexi
claude code·sonnet 4.6
Churn to date
218k tokens
186k in21k out
$1.84 42m of wall time
Commits drag to scrub
Where it works
Strength
Secrets it can reach values stay in the daemon, never in a prompt
ui/composer surface
held by Hexi
directory · 6 files
holding
since14:02 intentrestyle the control pills
The queue
Hexi working tree · opencoven
Files
Steer it
youKeep the radius at 999px on the small pills.
Hexi working
Working on
Spend
this session
Wall time
since it claimed
Token churn
inout
Where the tokens went
Tool calls, as they land tail −4
Overlap ui/composer waiting on you

Two claims on one surface.

Hexi has been writing in ui/composer since 14:02. Sage reached for the same shell at 14:19 and the runtime held it there.

Hexi
claude code
holds it
Claimed 14:02 · 38 minutes ago
Intent Restyle the composer control pills.
Sage
codex
held back
Claimed 14:19 · held on arrival
Intent Restyle the same shell from the token scale.
Hexi wrote it lines 142–145 · written
const pills = usePillState(session)
− radius: tokens.radius.sm,
+ radius: tokens.radius.full,
+ border: '1px solid ' + tokens.border.hairline,
Sage planned it lines 142–145 · never ran
const pills = usePillState(session)
− radius: tokens.radius.sm,
+ radius: scale.radius.pill,
+ boxShadow: none,

Both rewrite the same four lines of composer-shell.tsx, and they disagree about where the radius comes from. Whichever landed second would have quietly undone the first.

14:02
Hexi claims ui/composer. No one else is on it.
14:11
Hexi writes the pill radius and stages three files.
14:19
Sage asks for the same shell. The runtime holds it.
now
Neither has merged. The second write is still waiting.
Ways out
Split the surface Sage suggests

Sage only needs the token scale. Narrow its claim and both can work at once.

Hand it to Hexi Hexi suggests

38 minutes and 86 lines in, tests already green. Sage picks it up after the merge.

Say it yourself your call

Neither suggestion fits? Write the instruction and both familiars get it.

Sage research

Pill radius across the ecosystem

What the data looks like
Evidence
What we should do with it

The circle is open.Step in.

The runtime, the workspace, and the people building both. All of it public, all of it MIT.

CovenCave v0.2.1 · latest Notarized by Apple
Apple silicon 96.4 MB CovenCave-v0.2.1-aarch64.dmg
.sig
Intel 99.3 MB CovenCave-v0.2.1-x86_64.dmg
.sig
CovenCave v0.2.1 · latest SHA-256 published
x64 · installer 94.1 MB CovenCave_0.2.1_x64_en-US.msi
.sig

No Arm64 installer yet — the x64 build runs under emulation.

CovenCave v0.2.1 · latest SHA-256 published
amd64 · AppImage 199 MB CovenCave_0.2.1_amd64.AppImage
.sig

No .deb or .rpm yet — the AppImage runs on any distribution.

CovenCave v0.2.1 · latest Verified by Apple
iPhone and iPad iOS 17+ TestFlight beta · read-only board

TestFlight installs are signed by Apple and verified on device, so there is no checksum to run.

The board is read-only here; claims and merges happen in Cave.

MIT · runs locally · signed .dmg

Coven CLI ↗
The runtime itself. Read the source, file an issue, send a PR.
Docs ↗
Architecture, the socket API, familiars, and the security model.
Coven Code ↗
A terminal that ships no telemetry, built to host sessions.
Discord ↗
Ask questions and meet other people's familiars.