cc-sessions 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 52db66e364f567c81a0b225a661aef39244f8a05d2af99eb8984306c29496861
+  data.tar.gz: 582efdbb8033444176c073b79a3b79e2804ee126aabf263d2f00643419102d14
+SHA512:
+  metadata.gz: a883b1f7f0322e78d21d9bf7990697086a5f19d0822436470b4f905b483bc8c345ded04060c6d6c352c7af724326f3e445ce1e670e99b2006a859c14c947e595
+  data.tar.gz: ee039f8506c02760a62c9bbd423fccc6f44a2be6420e6b80f269a0ef534b84dad6f9562b2561365a1a64295906683726cb6aa26d73c0b5ba0aef9e7d8788bd95

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## [1.0.0] - 2025-01-23
+
+### Added
+- Initial release
+- `cc` command to manage Claude Code sessions
+- `/bm` slash command for bookmarking sessions with tags
+- `cc <tag>` to resume session by tag
+- `cc -l` to list all bookmarked sessions
+- `cc -h` for help
+- Auto-install of `/bm` command on first run

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geir Isene
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,94 @@
+# CC-sessions
+
+A simple tool for bookmarking and resuming Claude Code sessions with tags.
+
+## The Problem
+
+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 tag2` inside Claude Code
+- **Resume sessions** with `cc tag` from anywhere
+- **List bookmarks** with `cc -l`
+- **Auto-install** the `/bm` command on first run
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/isene/CC-sessions.git
+cd CC-sessions
+
+# Add to your PATH (add to .zshrc or .bashrc)
+export PATH="$HOME/path/to/CC-sessions/bin:$PATH"
+
+# Or create a symlink
+ln -sf /path/to/CC-sessions/bin/cc ~/bin/cc
+```
+
+## Usage
+
+### Bookmarking Sessions
+
+Inside a Claude Code session, use the `/bm` command:
+
+```
+/bm rtfm ruby filemanager
+```
+
+This bookmarks the current session with three tags. You can later resume it
+using any of those tags.
+
+### Resuming Sessions
+
+```bash
+# Resume session tagged 'rtfm'
+cc rtfm
+
+# Continue session in current directory (or start new)
+cc
+
+# List all bookmarked sessions
+cc -l
+
+# Show help
+cc -h
+```
+
+### First Run
+
+On first run, `cc` automatically installs the `/bm` command to `~/.claude/commands/`.
+This enables the `/bm` command inside Claude Code.
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `~/.cc-sessions/bookmarks.json` | Stores your bookmarks |
+| `~/.claude/commands/bm.md` | The `/bm` command definition |
+
+## Example Workflow
+
+```bash
+# 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
+```
+
+## Requirements
+
+- Ruby 2.7+
+- Claude Code CLI (`claude`)
+
+## License
+
+MIT

data/bin/cc

@@ -0,0 +1,165 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# CC - Claude Code Session Manager
+# Easily bookmark and resume Claude Code sessions with tags
+#
+# Usage:
+#   cc              - Continue session in current dir, or start new
+#   cc <tag>        - Resume session bookmarked with <tag>
+#   cc -l, --list   - List all bookmarked sessions
+#   cc -h, --help   - Show help
+#
+# Bookmarking (in Claude Code):
+#   /bm tag1 tag2   - Bookmark current session with tags
+
+require 'json'
+require 'fileutils'
+
+CONFIG_DIR = File.expand_path('~/.cc-sessions')
+BOOKMARKS_FILE = File.join(CONFIG_DIR, 'bookmarks.json')
+COMMAND_SOURCE = File.expand_path('../commands/bm.md', __dir__)
+COMMAND_DEST = File.expand_path('~/.claude/commands/bm.md')
+
+def ensure_setup
+  # Create config directory
+  FileUtils.mkdir_p(CONFIG_DIR) unless Dir.exist?(CONFIG_DIR)
+
+  # Install /bm command if not present
+  unless File.exist?(COMMAND_DEST)
+    if File.exist?(COMMAND_SOURCE)
+      FileUtils.mkdir_p(File.dirname(COMMAND_DEST))
+      FileUtils.cp(COMMAND_SOURCE, COMMAND_DEST)
+      puts "Installed /bm command to #{COMMAND_DEST}"
+      puts "You can now use '/bm tag1 tag2' in Claude Code to bookmark sessions."
+      puts
+    end
+  end
+end
+
+def load_bookmarks
+  return {} unless File.exist?(BOOKMARKS_FILE)
+  JSON.parse(File.read(BOOKMARKS_FILE))
+rescue JSON::ParserError
+  {}
+end
+
+def find_session_by_tag(tag)
+  bookmarks = load_bookmarks
+  bookmarks.each do |path, tags|
+    return path if tags.include?(tag)
+  end
+  nil
+end
+
+def session_exists_in_dir?(dir)
+  # Check for .claude directory with session files
+  claude_dir = File.join(dir, '.claude')
+  return false unless Dir.exist?(claude_dir)
+
+  # Look for conversation files or other session indicators
+  Dir.glob(File.join(claude_dir, '**/*')).any? { |f| File.file?(f) }
+end
+
+def list_bookmarks
+  bookmarks = load_bookmarks
+
+  if bookmarks.empty?
+    puts "No bookmarked sessions."
+    puts
+    puts "To bookmark a session, use '/bm tag1 tag2' in Claude Code."
+    return
+  end
+
+  puts "Bookmarked Claude Code sessions:"
+  puts
+
+  bookmarks.each do |path, tags|
+    exists = Dir.exist?(path) ? '' : ' [NOT FOUND]'
+    puts "#{path}#{exists}"
+    puts "  Tags: #{tags.join(', ')}"
+    puts
+  end
+end
+
+def show_help
+  puts <<~HELP
+    CC - Claude Code Session Manager
+
+    Easily bookmark and resume Claude Code sessions with tags.
+
+    USAGE:
+      cc              Continue session in current directory, or start new
+      cc <tag>        Resume session bookmarked with <tag>
+      cc -l, --list   List all bookmarked sessions
+      cc -h, --help   Show this help
+
+    BOOKMARKING (inside Claude Code):
+      /bm tag1 tag2   Bookmark current session with one or more tags
+
+    EXAMPLES:
+      cc rtfm         Resume session tagged 'rtfm'
+      cc              Continue in current dir or start fresh
+      cc -l           Show all bookmarked sessions
+
+    FILES:
+      ~/.cc-sessions/bookmarks.json   Bookmark storage
+      ~/.claude/commands/bm.md        The /bm command definition
+
+    FIRST RUN:
+      On first run, cc installs the /bm command to ~/.claude/commands/
+      This enables the '/bm' command inside Claude Code sessions.
+  HELP
+end
+
+def resume_session(path)
+  unless Dir.exist?(path)
+    puts "Error: Directory not found: #{path}"
+    exit 1
+  end
+
+  Dir.chdir(path) do
+    puts "Resuming session in: #{path}"
+    # Use -c to continue most recent session in this directory (no picker)
+    exec('claude', '-c')
+  end
+end
+
+def continue_or_start
+  if session_exists_in_dir?(Dir.pwd)
+    exec('claude', '-c')
+  else
+    exec('claude')
+  end
+end
+
+# Main
+ensure_setup
+
+case ARGV[0]
+when '-h', '--help'
+  show_help
+when '-l', '--list'
+  list_bookmarks
+when nil
+  continue_or_start
+else
+  tag = ARGV[0]
+  path = find_session_by_tag(tag)
+
+  if path
+    resume_session(path)
+  else
+    puts "No session found with tag '#{tag}'"
+    puts
+    puts "Available tags:"
+    bookmarks = load_bookmarks
+    if bookmarks.empty?
+      puts "  (none - use '/bm tag1 tag2' in Claude Code to bookmark)"
+    else
+      all_tags = bookmarks.values.flatten.uniq.sort
+      all_tags.each { |t| puts "  #{t}" }
+    end
+    exit 1
+  end
+end

data/commands/bm.md

@@ -0,0 +1,53 @@
+# Bookmark Session
+
+Bookmark the current Claude Code session with tags for easy resumption later.
+
+## Arguments
+
+The user provides space-separated tags after `/bm`. For example:
+- `/bm rtfm` - one tag
+- `/bm rtfm ruby filemanager` - multiple tags
+
+## What to Do
+
+1. Get the current working directory (this is the session path)
+2. Parse the tags from the command arguments (the text after `/bm`)
+3. Store the bookmark in `~/.cc-sessions/bookmarks.json`
+4. If no tags provided, show current bookmark for this directory (if any)
+
+## Implementation
+
+Run this bash command, replacing `$TAGS` with the actual tags provided:
+
+```bash
+mkdir -p ~/.cc-sessions && ruby -rjson -e '
+  file = File.expand_path("~/.cc-sessions/bookmarks.json")
+  bookmarks = File.exist?(file) ? JSON.parse(File.read(file)) : {}
+  cwd = Dir.pwd
+  tags = ARGV
+  if tags.empty?
+    if bookmarks[cwd]
+      puts "Current bookmark: #{bookmarks[cwd].join(", ")}"
+    else
+      puts "No bookmark for this directory. Usage: /bm tag1 tag2 ..."
+    end
+  else
+    bookmarks[cwd] = tags
+    File.write(file, JSON.pretty_generate(bookmarks))
+    puts "Bookmarked: #{cwd}"
+    puts "Tags: #{tags.join(", ")}"
+    puts ""
+    puts "Resume later with: cc #{tags.first}"
+  end
+' $TAGS
+```
+
+## Response Format
+
+After bookmarking, confirm:
+```
+Bookmarked: /path/to/session
+Tags: tag1, tag2, tag3
+
+Resume later with: cc tag1
+```

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: cc-sessions
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Geir Isene
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-23 00:00:00.000000000 Z
+dependencies: []
+description: A simple tool for bookmarking and resuming Claude Code sessions. Tag
+  sessions with meaningful names using /bm inside Claude Code, then quickly resume
+  them with 'cc <tag>' from anywhere.
+email:
+- g@isene.com
+executables:
+- cc
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/cc
+- commands/bm.md
+homepage: https://github.com/isene/CC-sessions
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/isene/CC-sessions
+  source_code_uri: https://github.com/isene/CC-sessions
+  changelog_uri: https://github.com/isene/CC-sessions/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: Bookmark and resume Claude Code sessions with tags
+test_files: []