Unwritten
About
The free, agent-native slice of change coupling.
Details
- Author
- byggarepop
- Categories
- Developer Tools
Jump to
Setup
Install Unwritten in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/byggarepop/Unwritten
Follow the installation instructions in the repository README, then restart your MCP client.
Catch the files you — or your AI agent — forgot to change.Unwritten learns from your git history which files usually change together and warns when one is missing from your edit: "you changedOrderService.csbut notOrderServiceTests.cs, and they change together 94% of the time." It calls these missing companionsholes, and every warning comes with its confidence score and real example commits as proof.
1 possible hole(s): src/Orders/OrderServiceTests.cs expected because you changed src/Orders/OrderService.cs confidence 0.826 (90 co-changes in 100 changes) e.g. 3f2a1c9 Add surcharge handling to freight calculation FAIL: at least one hole at confidence >= 0.70.
It runs as anMCP serverso AI coding agents (Claude Code, Copilot) can check their own edits mid-session, and as aCLIfor pre-commit hooks. Onedotnet tool execute, an index in.unwritten/, no server, no subscription, no tokens.
Works on any language.File-level rules only need git history, so hole detection works the same on Python, TypeScript, Go, or mixed repos. C# repos additionally get method-level rules and cosmetic-edit filtering; JSON files get key-level noise filtering. Running the tool requires the.NET SDK(10+), but the repos it analyzes can be anything.
- Warm up the index (optional — every command builds it on first use and keeps it current by itself; this just makes the first query fast).
dotnet tool execute Unwritten --yes -- reindex
- Register as an MCP server (Claude Code):
claude mcp add unwritten -- dotnet tool execute Unwritten --yes -- mcp
- (Recommended if using Claude Code) Make the check deterministic — a git pre-commit hook and a Claude Code Stop hook that feeds failing holes back to the agent before a commit is made:
dotnet tool execute Unwritten --yes -- install-hook --git --claude-code
That's it — your agent can now callcheck_holesafter editing, and the hooks catch the cases where it forgets to.
https://github.com/user-attachments/assets/4ae7a22d-c611-458f-8c48-08f87eca1d29
statsshows what the tool has learned — here, one file pair coupled strongly enough (confidence ≥ 0.7) to block a commit if one side is missing:
After editing one file of that pair,checkwarns that its companion is missing and spells out the three ways to resolve it — update the companion, commit anyway, or mute the rule:
With the pre-commit hook installed, the same check runs automatically on every commit and blocks it while the companion is still missing:
Everything else lives indocs/README.md:
- Background & the research behind it
- Why these thresholds (tested on real data)
- Use: MCP server, CLI, hooks, muting false rules
- Configuration reference
- How it works
- What it does NOT do (yet)
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Create crafted UI components inspired by the best 21st.dev design engineers.
Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent
ALAPI MCP Tools,Call hundreds of API interfaces via MCP
AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform
MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.
APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
