CC-sessions
A simple tool for bookmarking and resuming Claude Code sessions with tags.
Claude Code sessions are tied to directories, making it hard to remember where you were working on specific projects. This tool lets you tag sessions with meaningful names and quickly resume them.
Features
-
Bookmark sessions with
/bm tag1 tag2inside Claude Code -
Check bookmark with
/bm?to see current tags -
Resume sessions with
cc tagfrom anywhere -
Interactive list with
cc -l(arrow keys or j/k to navigate) -
Delete bookmarks with
din list orcc -d tag -
Auto-install the
/bmcommand and permission on first run - Zero dependencies - pure Ruby
Installation
From RubyGems (Recommended)
gem install cc-sessionsFrom Source
git clone https://github.com/isene/CC-sessions.git
cd CC-sessions
./install.shUsage
Bookmarking Sessions
Inside a Claude Code session, use the /bm command:
/bm rtfm ruby filemanager # Bookmark with tags
/bm? # Show current bookmark status
This bookmarks the current session with three tags. You can later resume it using any of those tags.
Resuming Sessions
cc # Continue session in current dir, or start new
cc <tag> # Resume session bookmarked with <tag>
cc -l, --list # Interactive list (↑/↓/j/k, Enter, d=delete, q=quit)
cc -d, --delete <tag> # Delete bookmark matching <tag>
cc -h, --help # Show helpFirst Run
On first run, cc automatically:
- Installs the
/bmcommand to~/.claude/commands/ - Adds auto-accept permission to
~/.claude/settings.json
This enables /bm to work without confirmation prompts.
Files
| File | Purpose |
|---|---|
~/.cc-sessions/bookmarks.json |
Stores your bookmarks |
~/.claude/commands/bm.md |
The /bm command definition |
~/.claude/settings.json |
Permission for auto-accept |
Example Workflow
# Start working on RTFM project
cd ~/projects/rtfm
claude
# Inside Claude Code, bookmark it
/bm rtfm ruby filemanager
# Later, from anywhere
cc rtfm # Instantly back in that session
# Or browse all bookmarks
cc -l # Pick from interactive listRequirements
- Ruby 2.7+
- Claude Code CLI (
claude)
License
This software is released into the public domain under The Unlicense.