DoneGraph
Turn your work with AI into a visible achievement graph: what you asked for, what changed, what was proven, what is blocked, and where the next session should continue.
Works as a local plugin for Codex, Claude Code, Cursor, VS Code Copilot, and shell-based AI workflows.
English | 简体中文
You have been building with an AI agent for three hours. It edited files, ran tests, changed direction twice, and left a long chat behind. What is actually done?
DoneGraph is a local AI collaboration plugin that turns goals, actions, decisions, artifacts, evidence, blockers, and next steps into a .donegraph/ folder you can hand to someone else. The dashboard gives a judge, teammate, or next AI session the state of the work without making them reread the whole conversation.
The point is simple: progress should feel earned, inspectable, and easy to resume.
Features
Capture The Current Context
Run /donegraph-capture when you join an existing task. DoneGraph reads local context such as changed files, file names, package.json scripts, and an optional goal, then turns that into starting collaboration events.
Track Human-AI Progress
Record meaningful checkpoints as the task moves forward: implementation work, design decisions, generated artifacts, verification results, blockers, and completion milestones.
Show Evidence, Not Just Activity
Progress is tied to proof. A passing command, manual check, failing test, unknown verification state, or blocker becomes part of the graph instead of disappearing into chat history.
Generate A Local Dashboard
Open .donegraph/dashboard.html to see what was completed, which evidence supports it, how the records connect, and where the next session should pick up.
Publish A Safe Snapshot
Generate .donegraph/safe-snapshot.json when you want to share one AI run without exposing the raw chat, file contents, local paths, or secret-looking values. The hosted share.html page can import that snapshot in the browser, and /api/snapshots can store it when Supabase is configured.
Resume Large Tasks Cleanly
DoneGraph writes achievement-log.md and next-steps.md so the next AI session can continue from the real task state instead of asking you to reconstruct the story.
Stay Clean-Room
DoneGraph does not import external code graphs, third-party graph schemas, or .understand-anything artifacts. Its graph models one thing only: collaboration progress between a person and AI.
Quick Start
1. Install The Plugin
From a local checkout:
./install.sh codex
After installation, restart your CLI or IDE. The installer links the DoneGraph skills for the selected platform and creates a universal local plugin entry:
~/.donegraph-plugin
From GitHub:
curl -fsSL https://raw.githubusercontent.com/serein431/DoneGraph/main/install.sh | bash -s codex
Native plugin package shape:
.agents/plugins/marketplace.json
plugins/donegraph/.codex-plugin/plugin.json
plugins/donegraph/skills/
plugins/donegraph/scripts/donegraph
The marketplace entry points at ./plugins/donegraph, which is the validated plugin root. Skills call the plugin-owned wrapper by relative path, so the package can run as a self-contained plugin.
2. Start A Session
/donegraph-start Ship a hackathon demo that shows AI progress clearly
If you are joining an existing task, capture local context first:
/donegraph-capture --goal "Ship a standalone clean-room DoneGraph demo"
3. Record Progress
/donegraph-checkpoint Implemented the command-first DoneGraph CLI --command "npm test"
/donegraph-proof Tests passed --pass --command "npm test"
/donegraph-done The demo can show completed work, evidence, and the next handoff
4. Open The Dashboard
/donegraph-dashboard
DoneGraph writes:
.donegraph/session.jsonl
.donegraph/task-graph.json
.donegraph/achievement-log.md
.donegraph/next-steps.md
.donegraph/dashboard.html
.donegraph/safe-snapshot.json
.donegraph/safe-snapshot.md
The dashboard includes a real-run replay, a guided walkthrough, a copyable plain-language summary, and a daily recap letter written by the AI for the user.
For hackathon review, open landing.html after npm run demo. It gives judges a product landing page first, with the real dashboard embedded inside the page.
Commands
Plugin commands:
/donegraph-start <goal>
/donegraph-capture [--goal <goal>] [--platform codex|claude|cursor|generic]
/donegraph-checkpoint <what changed> [--command <cmd>] [--path <file>]
/donegraph-proof <proof text> --pass|--fail|--blocked|--unknown [--command <cmd>]
/donegraph-done <completion summary>
/donegraph-dashboard [--no-open]
/donegraph-summary
/donegraph snapshot
/donegraph publish --target https://donegraph.space
Terminal fallback:
