An observatory for the Regen ecosystem. Regen Heartbeat generates structured digests about Regen Network, RegenAI, and the Regen Commons -- pulling live data from the blockchain, the KOI knowledge commons, and the wider web, then synthesizing it into readable reports voiced through twelve distinct character personas. The digests are published as a static site via Quartz on GitHub Pages, building an accumulating record of what the ecosystem is doing, thinking, and becoming.
This repository also serves as a working template for Claude Code. Every structural choice -- the skills, output styles, character pipeline, MCP integrations, template system -- is designed to be studied and learned from. Clone it, read it, and you will understand not just what Regen Heartbeat does, but how Claude Code works.
Data flows through four stages. First, MCP tools query live sources: the KOI knowledge base searches 6,500+ documents across Notion, GitHub, Discourse, and governance records, while the Ledger MCP reads directly from the Regen blockchain for proposals, ecocredits, supply, and marketplace data. Web search adds current events from the broader world. Second, templates define the shape of each digest -- what sections to include, what data to gather for each one. Third, the generating agent synthesizes everything into a coherent narrative, optionally voiced through a character persona. Fourth, the finished digest lands as a markdown file in the content directory, where Quartz renders it into a static site deployed to GitHub Pages.
/current-events-- Search the web for current events relevant to the Regen ecosystem/daily-- Generate a daily digest with data from KOI, Ledger, and web sources/weekly-- Generate a weekly rollup from daily digests (Phase 2)/monthly-- Generate a monthly rollup from weekly digests (Phase 2)/yearly-- Generate a yearly rollup from monthly digests (Phase 2)/plans-- View and manage active plans (Phase 3)/roadmap-- View per-group roadmaps (Phase 3)/goals-- View and manage goals (Phase 3)/decisions-- Track open and closed decisions (Phase 3)
regen-heartbeat/
├── content/ Quartz content root
│ ├── index.md Homepage
│ ├── digests/ Digest archive (YYYY/MM/DD/daily.md)
│ └── docs/ MCP documentation (Diataxis framework)
├── templates/ Digest blueprints by cadence
│ ├── daily/ Daily templates (active)
│ ├── weekly/ Weekly templates (Phase 2)
│ ├── monthly/ Monthly templates (Phase 2)
│ └── yearly/ Yearly templates (Phase 2)
├── .claude/
│ ├── characters/ Character persona definitions (ElizaOS JSON)
│ ├── output-styles/ Writing style instructions per character
│ ├── skills/ Command skills and character skills
│ ├── specs/ System specifications and roadmap
│ └── rules/ Behavioral guidelines and ethos
├── settings.json Topics, defaults, and site configuration
├── quartz.config.ts Quartz site configuration
├── quartz.layout.ts Quartz page layout
└── .github/workflows/
└── deploy.yml GitHub Pages deployment
Twelve characters voice digests with distinct perspectives. They are organized into three groups:
Regen -- The institutional voices of Regen Network and its community.
- Narrator bridges complex ideas to broad audiences through storytelling
- RegenAI speaks as the technical lead and systems orchestrator
- Governor focuses on governance, consensus, and collective decision-making
- Facilitator orchestrates partnerships and ecosystem development
- Advocate mobilizes the community through education and outreach
- VoiceOfNature channels philosophical depth and wisdom traditions
Gaia -- Voices from deeper ecological, technological, and legal perspectives.
- Gaia speaks as planetary intelligence and ecohyperstition
- TerraNova grounds everything in soil carbon and ecosystem dynamics
- Genesis architects autopoietic systems and AI engineering
- Astraea brings regenerative law and legal frameworks
- Aquarius flows through water systems and hydrological thinking
Bioregion -- Place-rooted voices.
- Cascadia speaks from the Pacific Northwest bioregion
Generate your first digest:
/daily
Or with a character voice:
/daily --character narrator
Search for current events:
/current-events --creative --deep
Preview the site locally:
npx quartz build --serve
- Getting Started Tutorial
- KOI MCP Tool Reference
- Ledger MCP Tool Reference
- The Regen Ecosystem
- Why These MCPs?
- KOI MCP -- Regen knowledge base search, entity resolution, weekly digests, GitHub docs
- Ledger MCP -- Regen blockchain queries for governance, ecocredits, marketplace, supply