Bookmark

Bookmark

Git-backed conversational context tracking for Claude Code.

The gist

You're working on something, have a nice lil chat going, and then auto-compaction kicks in and you lose all the juicy details.

This plugin tracks conversation context using git worktrees. Your contexts live on an orphan branch—same repo, separate history, no submodule weirdness. Just normal git commands.

Commands

Command	What it does
/bookmark:start [topic]	Start or resume tracking something
/bookmark:update [topic]	Save current progress
/bookmark:recall [topic]	Load context back in
/bookmark:search [query]	Find stuff
/bookmark:list	See everything
/bookmark:resolve [topic]	Mark it done
/bookmark:history [topic]	Git log for a topic

Quick example

/bookmark:start auth-oauth     # start tracking
# ... do work ...
/bookmark:update auth-oauth    # save where you're at

# later, new session
/bookmark:recall auth-oauth    # pick up where you left off

How it works

Uses git worktree with an orphan branch:

your-project/
├── .git/                     # main repo
├── .gitignore                # includes .claude/cc-bookmarks/
├── .claude/
│   └── cc-bookmarks/         # worktree on "cc-bookmarks" branch
│       ├── auth-oauth.md
│       └── battle-system.md
└── src/...

• Main branch: your code, never sees context files
• cc-bookmarks branch: orphan, only context files, separate history
• Same repo, normal git commands, no special flags

Claude keeps notes terse and flags anything unclear in an ## Unresolved section so nothing gets lost between sessions.