Open-source CLI tool that snapshots your Cursor, Claude Code, or Windsurf session and lets teammates resume in one command. No more lost context, re-explaining, or "what were you working on?".
Open-source CLI tool that snapshots your Cursor, Claude Code, or Windsurf session and lets teammates resume in one command. No more lost context, re-explaining, or "what were you working on?".
Capture git diff, your one-line note, last AI messages, inferred open files, and the active branch into a per-thread markdown file. The AI tool config files HuddleUp generates carry a Token Exhaustion Protocol so the AI itself runs `huddleup snapshot` when context is about to overflow.
Teammates run one `huddleup resume` command and get a YOU ARE HERE briefing, the relevant files opened in the editor, and a context file the AI tool reads on its next prompt.
The extension adds a sidebar panel with Snapshot, Resume, and Standup buttons plus a per-thread Resume/Archive list. Every action is also in the command palette.
Works with Cursor, Claude Code, Windsurf, GitHub Copilot, and OpenAI Codex CLI. detectAllAdapters() captures messages from every detected tool and merges them into one snapshot — the thread's Tools field lists everyone who contributed.
The whole .huddleup/ folder is plain markdown plus JSONL history — commit it to git, paste it in Slack, attach it to a Linear ticket. No cloud, no accounts, no data leaves your machine. Optional handoffWebhook posts a JSON payload when you explicitly call `huddleup handoff <teammate>`.
Open source (AGPL-3.0), CLI-first, Node.js 20+. Dependencies are intentionally small (commander, inquirer, chalk, simple-git, conf). Uninstall any time — your .huddleup/ folder is still useful as plain markdown.
No config files, no YAML, no platform accounts. Just a CLI that does one thing well.
$ npm install -g huddleupRequires Node.js 20+. Also available as a VS Code extension once published to the Marketplace.
$ cd your-project
huddleup initScaffolds .huddleup/ (charter, threads, history) and generates one config file per AI tool: CLAUDE.md, .cursor/rules/huddleup.mdc, AGENTS.md, .windsurfrules.
$ huddleup snapshotCaptures git diff, last AI messages from every detected tool (Claude Code, Cursor, Codex, Copilot, Windsurf), the active branch, your one-line note, and a list of inferred open files. Writes to .huddleup/threads/<name>.md.
$ git add .huddleup/
git commit -m "wip: handoff"
git pushThe whole .huddleup/ folder is plain markdown plus JSONL — meant to be committed. Or use `huddleup handoff <teammate>` to snapshot + auto-commit + fire a Slack/Discord webhook in one shot.
$ huddleup resume streaming-chat-endpointPrints a "YOU ARE HERE" briefing, opens the inferred files in your editor, and writes a context file the AI tool reads on its next prompt. Zero re-explanation.
HuddleUp auto-detects every tool installed on the machine. Multiple adapters can match; their messages and open-file lists merge into a single snapshot.
Reads ~/.cursor/{sessions,chats}/ and the workspaceStorage folders under VS Code-style globalStorage on macOS, Linux, and Windows.
Reads ~/.claude/projects/<hash>/*.jsonl (modern) and ~/.claude/sessions/*.jsonl (legacy). Writes CLAUDE.md with the Token Exhaustion Protocol.
Detects ~/.windsurf/, ~/.codeium/, and the Windsurf/Codeium application data folders across platforms.
Reads VS Code globalStorage (github.copilot-chat) for Code, Code Insiders, and Cursor; also ~/.github/copilot/ and ~/.vscode/copilot/.
Detects ~/.codex/ and the Codex app data folders on macOS, Linux, and Windows. Parses JSON, JSONL, and plain-log session files.
Add a new adapter in src/adapters/ — implement detect() + capture() and call registerAdapter(). About 80 lines. See docs/adapters.md.
No sign-up, no account, no backend. Just Node.js, git, and a terminal.
# 1. Install the CLI
$ npm install -g huddleup
# 2. Set up HuddleUp in your project (creates .huddleup/ + CLAUDE.md, .cursor/rules/huddleup.mdc, AGENTS.md, .windsurfrules)
$ cd your-project
$ huddleup init
→ HuddleUp is ready! Edit .huddleup/charter.md and run "huddleup sync".
# 3. Save your AI session before a break
$ huddleup snapshot
? Where did you leave it? Streaming /chat broken, suspect CORS
→ Snapshot saved to threads/streaming-chat-endpoint.md
# 4. Your teammate picks up - in whichever AI tool they use
$ huddleup resume streaming-chat-endpoint
→ YOU ARE HERE briefing prints, relevant files open, AI tool gets full contextHuddleUp is free, open source, and ready to use. No accounts, no data uploads, no strings attached.