What it does
gitdone keeps a markdown table of what must exist for a project to be complete. A row counts as Live only when a commit on the default branch or a merged pull request says so. Each project gets a strict percentage, which counts only Live rows, and a weighted percentage, which also credits work built on a branch (0.8 by default) or partially built (0.4 by default). It writes a STATUS.md view, a README badge, SVG charts of the table's git history, a portfolio summary across several repositories, and a Markdown report with the evidence for each row. A commit that would make the numbers inaccurate is refused by the gate.
This suits a developer who wants to check whether an agent's claim that work shipped is backed by git, or who needs to track progress across several projects. It also suits anyone who has to give a client or manager a row-by-row account of progress. The GitHub Action comments on pull requests that move a row and marks each finding on the matching line of the diff.
Installation uses pipx, uv, pip or uvx. A coding agent can be connected through the Claude Code plugin, the npx skills command, any MCP client, or an AGENTS.md rules file. The pre-commit, pre-merge-commit and post-commit hooks are written to .git/hooks and apply to that clone only.
Limitations and requirements
Requires Python 3.9 or newer and git. The gh command-line tool is needed for rows that name a GitHub pull request, and glab for GitLab merge requests. The git hooks apply only to the clone where they are installed.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
gitdone
Read-only project status: strict and weighted completion, each claim held to git.
v0.3.0As shown on registry.modelcontextprotocol.io when we last read it