Local-first observability and coordination platform for AI-assisted development.
| Layer | Role |
|---|---|
.htmlgraph/*.html |
Canonical store — single source of truth |
SQLite (~/.cache/htmlgraph/<path-hash>/htmlgraph.db) |
Per-user read index for queries and dashboard (derived; not committed) |
Go binary (htmlgraph) |
CLI + hook handler |
All CLI usage, safety rules, and best practices are delivered by the HtmlGraph plugin.
Run htmlgraph help --compact for the CLI reference.
HtmlGraph currently ships the same plugin to three AI coding harnesses:
- Claude Code — plugin tree at
plugin/ - Codex CLI — plugin tree at
packages/codex-plugin/ - Gemini CLI — extension tree at
packages/gemini-extension/
All three trees are generated from the same source of truth at
packages/plugin-core/manifest.json by htmlgraph plugin build-ports. Shared
markdown assets (commands, agents, skills, templates) live in plugin/…/ and are
copied verbatim into every target — the formats are compatible across harnesses,
so a new slash command or skill lands in all three at once. See
packages/plugin-core/README.md for details.
This project uses HtmlGraph to develop itself. .htmlgraph/ contains real work items — not demos.
A UserPromptSubmit hook injects the current local timestamp (with timezone) on every user prompt. Use it to reason about elapsed time between messages — detect stale context in long sessions, recognize when a session has been resumed after a gap, and avoid treating old references as fresh.