Show HN: Handoff-md – One command to generate portable AI context from any repo

1 point

3 months ago

Every time you switch AI models mid-project, the new model starts from zero. It doesn't know your stack, your conventions, or what you were working on five minutes ago.

I built handoff-md to fix this. It's a CLI tool that analyzes your git repo and generates a single HANDOFF.md file. Paste it into any AI model and it instantly understands your project.

What it does:

- Parses git history (last 20 commits, branches, uncommitted changes) - Detects your stack (framework, ORM, DB, auth, deploy, test runner) - Reads naming conventions, folder structure, API patterns - Picks up existing AI config files (CLAUDE.md, .cursorrules, AGENTS.md) - Outputs a single markdown file, around 3000 tokens

Usage: npx handoff-md

No config, no API keys, no dependencies beyond Node.js and git. Works with Claude, GPT, Gemini, Codex, local models, anything that reads markdown.

There's an open issue in Claude Code (#11455) requesting exactly this. Cursor, Windsurf, and Copilot don't have it either. So I built it as an open source CLI that works everywhere.

Built with TypeScript. MIT licensed. Feedback welcome.