geneseed weekly downloads statistics

<div align="center">

🧬 Geneseed

A portable, theme-able harness you implant once and use everywhere to grow a disciplined AI coding agent.

Why · Setup · Web & terminal · What you get · Ownership · Harnesses · Docs

</div>

---

<p align="center"><img src="docs/assets/demo.svg" alt="geneseed setup, then two laws catching a force-push and a credential at the tool boundary" width="760"></p>

Geneseed compiles your agent's rules instead of asking you to write them. One source in src/ renders into a ready-made harness for OpenCode, Claude Code, Bob, OpenClaude, or any AGENT.md tool: a constitution of laws and doctrines, a roster of capability agents, native skills, a memory convention — and, wherever the host has a hook surface, gates that enforce the laws at the tool boundary instead of hoping the model remembers them.

npx geneseed setup

Want to read what it leaves behind before installing anything? geneseed-demo is a repository exactly as the plain bundle emits it — nothing hand-written.

Why not just a CLAUDE.md?

A hand-written instructions file is prose the model may or may not honour, copied into every repo and drifting in each one. Geneseed is a build, and that changes five things:

• Laws are enforced, not suggested. A force-push to main, a reset --hard that abandons unpushed commits, or a credential written into a tracked file is caught by a hook before the tool runs, in the host's own dialect — a prompt on Claude Code and OpenClaude, a hard block on OpenCode, exit 2 on Bob. The gates fail closed, and every catch is one line in a ledger that geneseed status counts.
• The developer stays the owner of the code. In a production application the agent proposes and the developer decides — per feature, per file or per function, as the team sets in a committed AGENTS.md. Interfaces and sensitive zones are always a checkpoint, complex parts are explained before they land, and a hook stops the first write in an application that has not chosen yet. Ownership →
• One source, five targets. Skills are byte-identical on every host; only the wiring differs. Every commit renders all 263 emit configurations, and a second emit into the same tree must change nothing.
• Costs are measured, not guessed. Zero runtime dependencies. The hook path loads in about 14 ms per tool call. The default lean footprint keeps the always-on context small and puts the full rationale one read away — the numbers are in docs/token-footprint.md.
• It follows you. Install once, globally; every repo inherits it. One git pull or npm install -g geneseed@latest rebuilds every active install.

This page is the overview. New to agent harnesses? Start with Understand — a short course on what a harness is, what lands on your machine, what changes in your day, and what is enforced versus only asked. Everything else — every install path, configuration knob, and troubleshooting step — is in the documentation, which the web console also renders.

Scored, not claimed

<p align="center"><a href="#ai-harness-scorecard"><img src="docs/assets/scorecard.svg" alt="AI Harness Scorecard for this repository: grade and score, with one bar per pillar" width="760"></a></p> <p align="center">_{31 deterministic checks, no LLM — <a href="#ai-harness-scorecard">how this is scored, and how to score your own repo</a>}</p>

---

🧬 1 · Why Geneseed

The name

The name comes from Warhammer 40,000. In the lore, gene-seed is a Space Marine Chapter's genetic legacy: implanted once into an aspirant, it rebuilds them from within, and every successor Chapter is founded from the gene-seed of its parent. That is exactly this project's model. The harness began life as a personal, Obsidian-vault-grown agent operating system; this repo is the genetic material distilled out of it — implant it once into your tool, and a disciplined agent grows around it, carrying the same inherited rules, agents, skills, and memory into every repo it touches.

The lineage is also why an imperial theme ships alongside the neutral one: it is the voice of the parent system the harness was extracted from. But the genetics are theme-independent — the name is a nod to the origin, not a commitment to Space Marines.

How it works…