HN Showcase
Back to browse
GitHub Repository

One command to generate a portable AI context file from any repo.

10 starsTypeScript

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

by guvencem·Feb 27, 2026·1 point·0 comments
Visit ProjectView on HN

AI Analysis

●●●BangerSolve My ProblemZero to One

One command generates portable AI context—replaces manual re-explaining between models.

Strengths
  • •Solves genuine friction: switching between Claude/GPT/Cursor without context loss
  • •Zero-dependency design (Node.js + git only) with no API keys or config required
  • •Auto-detects stack, conventions, TODOs, uncommitted changes—captures live project state
Weaknesses
  • •Relies on git history quality; sparse/messy repos produce weak context
  • •No built-in feedback loop to verify generated context matches developer intent
Target Audience

AI-assisted developers, multi-model workflow users, team leads managing code context

Similar To

CLAUDE.md · .cursorrules · Cursor Rules

Post Description

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.

Similar Projects