adhd-mcp

ADHD-friendly Cursor agent kit: Ponytail-style minimal code, on-demand Q&A, concise replies with status footer, context stats via MCP.

Install

cd your-project
npx adhd-mcp init

Reload MCP in Cursor → new Agent chat.

What init writes

| Path | Role | |------|------| | .cursor/rules/adhd.mdc | Ponytail ladder + output baseline (replaces ponytail.mdc) | | .cursor/skills/adhd-qa/ | Q&A clarification workflow | | .cursor/skills/adhd-output/ | Short reply + footer format | | .cursor/mcp.json | Merges adhd_mcp server | | adhd/sessions/ | Q&A session logs |

MCP tools

• estimate_context — context % (reported or ~heuristic)
• format_status_footer — 📊 理解 X% │ 进度 Y% │ ctx ~Z%
• check_readiness — block code until understanding ≥95%
• qa_session_start / qa_session_append — session files

v1 scope

✅ Rule + Skills + MCP + init
❌ GitHub search (v2) · hitl integration

Dev

npm install
npm run smoke
npm run local-test
node dist/index.js init --cwd /path/to/project --force --local

After publish, users run npx adhd-mcp init (uses npm; no --local).

License

MIT