cc-jump
v0.2.1
Published
Browse and resume Claude Code sessions organized by project directory
Downloads
568
Maintainers
Readme
npx cc-jumpNo install, no config. Run that one command from anywhere.
The problem
Claude Code's /resume only shows sessions from the directory you're in, in one flat list. If you work across several projects, there's no way to see them all and jump into the one you want.
cc-jump groups your sessions by project folder and lets you drill down to the one you want:
npx cc-jump
→ projects/ → personal/ → cc-jump (drill down a level at a time)
→ pick a session (shown with its title and timestamp)
→ you're back in Claude Code, in the right directorySingle-child folders are skipped so every menu is a real choice, and ← Back steps up a level. On the session list, press o to open that project in VS Code as well as resuming it in the terminal.
How it works
Claude Code stores each session as a .jsonl transcript under ~/.claude/projects/. cc-jump reads those, groups them into the folder tree your projects live in, and resumes the one you pick by running claude --resume in its directory.
It works out each project's real path by reading the working directory recorded inside the transcript (the folder names Claude Code uses aren't reliable to decode). For a session's label it uses the title Claude Code generated, or your first message as a fallback. It only reads your data — it never changes anything.
Requirements
- Node.js 18 or newer.
- The
claudeCLI on yourPATH(npm install -g @anthropic-ai/claude-code).cc-jumpchecks and tells you if it's missing.
Contributing
I built this for myself, but if it helps you too, that's the point. The code is kept small and readable on purpose, so it's easy to pick up — see CONTRIBUTING.md.
Similar tools
cc-jump does one thing: the simplest directory-first way to resume a session from a single npx command. If you want more — analytics, exporting, reading transcripts — these do that: cc-sessions, ccrider, claude-sessions-cli, claude-code-viewer.
License
MIT © ShovonCodes
