How ayush488-glitch/genesis-kit works
Genesis is a local, repository-native harness for resumable agent-assisted development. The main workflow captures a human-approved specification and plan, authorizes bounded task execution, verifies work against acceptance checks, and records evidence so work can be resumed. Its CLI also manages durable project state, checkpoints, and evaluated learning. A separate code-indexing branch supports queries, agent access, and local visualizations. The CLI is a large implementation hub; unsampled lifecycle details are represented only where the README documents them.
Main entry points: genesis.mjs Genesis CLI · query.mjs Index queries · serve.mjs Live view server · graphizer.mjs Code indexer
Components 19
Work lifecycle
- Genesis CLI
tools/genesis.mjs - Discovery
tools/genesis.mjs - Specification
tools/genesis.mjs - Planning
tools/genesis.mjs - Authorized execution
tools/genesis.mjs - Verification
tools/genesis.mjs
State and learning
- Project record
- Evidence receipts
- Context and recovery
tools/genesis.mjs - Evaluated learning
tools/genesis.mjs
Code intelligence
- Code indexer
tools/graphizer.mjs - Repository index
- Index queries
tools/query.mjs
User interfaces
- MCP interface
tools/mcp.mjs - Static dashboard
tools/dashboard.mjs - Live view server
tools/serve.mjs - Live control panel
tools/control-panel.mjs
Other components
- Human
- Coding host
Connections 22
- Human → Discovery: guides
README.md - Discovery → Specification: informs
README.md - Human → Specification: approves
README.md - Specification → Planning: defines work
README.md - Planning → Authorized execution: authorizes tasks
README.md - Coding host → Authorized execution: performs work
README.md - Authorized execution → Verification: submits for proof
README.md - Verification → Evidence receipts: records evidence
README.md - Genesis CLI → Project record: persists state
README.md - Genesis CLI → Context and recovery: builds context
README.md - Context and recovery → Coding host: supplies continuation
README.md - Genesis CLI → Evaluated learning: runs evaluations
README.md - Human → Evaluated learning: reviews promotion
README.md - Genesis CLI → Code indexer: runs indexing
- Code indexer → Repository index: writes index
README.md - Index queries → Repository index: reads index
tools/query.mjs - MCP interface → Index queries: delegates queries
tools/mcp.mjs - Genesis CLI → Index queries: serves queries
tools/genesis.mjs - Genesis CLI → Static dashboard: generates snapshot
tools/genesis.mjs - Live view server → Live control panel: serves page
tools/serve.mjs - Live view server → Index queries: uses queries
tools/serve.mjs - Static dashboard → Project record: renders state
README.md