repo-ready
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
π©Ί repo-ready
The doctor your repo needs before AI agents move in.
One command generates a truthful AGENTS.md + CLAUDE.md from what's actually in your repository β commands proven by CI, real directory map, env vars, guardrails, definition-of-done.
A second command audits them for drift, so your agent docs never rot again.
npx repo-ready init Β· npx repo-ready check Β· ships as CLI, Agent Skill and MCP server
Why Β· Quick start Β· Check mode Β· MCP & Skill
Why
Every AI coding agent asks the same first question: "what is this project and how do I run it?"
Today you answer it by hand-writing AGENTS.md β and then it silently rots: scripts get renamed, CI changes, folders appear.
repo-ready fixes both ends:
initβ generates agent docs from evidence: manifests, lockfiles, CI workflows, Makefiles β with a confidence column. "verified (manifest + runs in CI)" beats a hallucinated guess every day.checkβ audits existing docs against the live repo: dead commands, undocumented scripts, new directories, CI drift. Exit code 1 = unhealthy β drop it into CI.
β
Repo health: HEALTHY (100/100)
β
repo-ready managed (v0.1.0)
β
command OK: `npm run test`
β οΈ package.json has scripts not documented in AGENTS.md: `db:migrate`
β documented command `npm run ghost` no longer exists in package.json scriptsRelated MCP server: Doc Bridge
Quick start
Zero dependencies, zero config:
cd your-repo
npx repo-ready scan # see what it detected β no files written
npx repo-ready init # generate AGENTS.md + CLAUDE.md
npx repo-ready check # audit any time (CI-friendly exit codes)
npx repo-ready update # regenerate after the project evolvedWhat init writes (example from a real repo):
## Commands
| Purpose | Command | Confidence |
|---|---|---|
| install | `npm install` | verified (package.json + lockfile) |
| dev | `npm run dev` | verified (package.json scripts) |
| test | `npm run test` | verified (manifest + runs in CI) |
## Repository layout
src/ β application source code
public/ β static assets served as-is
scripts/ β utility / maintenance scripts
## Environment variables
- `DATABASE_URL` β no default, must be set
## Do not touch
- `dist/` is generated β never edit or commit it
- `.env` holds real secrets β never read it, commit it, or echo it
## Definition of done
- Run `npm run test` and make it pass before claiming a task is done
- Do not commit unless the user asked for a commitHand-written notes survive. Everything repo-ready owns sits between <!-- repo-ready:auto-start --> markers β your own paragraphs above and below them are kept on every update. A foreign (hand-written) AGENTS.md is never overwritten without --force.
What it detects
Languages | JS/TS, Python, Go, Rust, Java, Ruby, PHP, C/C++, Vue, Svelte, β¦ (extension census) |
Package managers | npm / pnpm / yarn / bun, poetry / uv / pipenv / pip, cargo, go modules |
Frameworks | Next.js, React, Vue, Express, Fastify, NestJS, FastAPI, Django, Flask, Gin, axum, β¦ |
Commands | from |
CI evidence | parses |
Guardrails | generated dirs, lockfiles, |
The check mode π©Ί
npx repo-ready check && echo "docs are honest" || echo "docs rotted"Verifies that every documented command still exists, flags scripts/dirs missing from the docs, compares against what CI actually runs, and scores the result 0β100 (healthy β₯ 90, stale, critical). Non-zero exit on anything but healthy β wire it into CI and your agent docs can never silently rot again.
Plug into your agent
ZCode / Claude Code β as a plugin (recommended)
Add this repo as a plugin marketplace and install β you get the skill, a /repo-ready command and the MCP server in one shot:
ZCode: Plugin Marketplace β Add β paste
temmeik/repo-readyβ install Repo ReadyClaude Code:
claude plugin marketplace add temmeik/repo-readyβ/plugin install repo-ready@repo-ready
As an Agent Skill (manual)
Copy skills/repo-ready/SKILL.md into your skills directory:
~/.claude/skills/repo-ready/SKILL.md β then just ask the agent to "make this repo agent-ready".
As an MCP server
# Claude Code
claude mcp add repo-ready -- npx github:temmeik/repo-ready mcp
# Codex (~/.codex/config.toml)
[mcp_servers.repo-ready]
command = "npx"
args = ["github:temmeik/repo-ready", "mcp"]Tools exposed: repo_scan Β· repo_generate Β· repo_check
Monorepo? Rust? Python?
Yes. Workspaces, Turborepo and pnpm-workspace are detected; Go/Rust/Python get native command sets (go test ./..., cargo test, poetry run pytest) β all covered by 41 e2e assertions in test/e2e.js, including a run against this repo's own sister project.
License
MIT β do whatever you want, a star is appreciated β
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Research-backed lint + generation for agent context files (CLAUDE.md, AGENTS.md) + prompt enhancer.
Generate and review codebase docs. 77 tools; scoped, credit-approved repository reviews.
Audit and write CLAUDE.md / AGENTS.md / Cursor rules; generate full build specs for new projects.
Look up 133 agentic-web standards, live-probe any domain, validate manifests, generate boilerplate.
Related MCP Servers
FlicenseNot gradedqualityDmaintenanceCP server that generates AGENTS.md and CLAUDE.md from your real repo, verifies every command actually exists, detects doc drift, and saves session context β all locally, no data leaves your machine. Free-tier friendly via Groq/NVIDIA.-
Doc Bridgeofficial
AlicenseNot gradedqualityAmaintenanceTurn repository documentation into deterministic, executable handoffs for coding agents through MCP, CLI, and CIβwithout an LLM or API key.12,244 npm10MIT- AlicenseNot gradedqualityCmaintenanceEnables auditing and drafting of AI agent files (CLAUDE.md, AGENTS.md, Cursor rules) and turning project descriptions into full build specs, with local and API-based tools.36 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to check their own instruction files for drift before a run, returning findings with file and line for stale counts, missing files, broken links, and missing commands. Also lets agents list which agent docs get inspected.14 npmMIT