Claude Code wrapper with session naming and auto-summarization

A developer created a Bash wrapper for Claude Code that adds session naming, listing, and management capabilities to the AI coding tool. The wrapper, named `cc`, supports named sessions, session resumption by name or index, and includes an opt-in Gemini-based auto-summarization feature for previous sessions when listing. The tool also implements safer destructive operations by using `trash` instead of `rm` and requires explicit confirmation with session count display for clearing all sessions.

| /usr/bin/env bash | | | cc - Claude Code wrapper with session naming | | | Adapted from https://gist.github.com/zinknovo/cf21268e90419e9c0e93a9bd448591a4 | | | | | | Local changes: | | | - Config dir defaults to ~/.claude-2 override via $CLAUDE CONFIG DIR | | | - Destructive ops use trash instead of rm per CLAUDE.md global rules | | | - clear requires typing "yes" + shows session count | | | - Gemini auto-summary is opt-in via CC AUTO SUMMARY=1 | | | - Removed check version depended on external check-cli-compat | | | | | | Usage: | | | cc Start a new Claude Code session | | | cc n <name Start a new session with a name | | | cc ls List sessions current project | | | cc lsa List sessions across all projects | | | cc r <name|index Resume a session by name or index | | | cc rn <index <name Rename a session | | | cc rm <name|index Delete trash a session | | | cc clear Delete trash all sessions | | | | | | Env: | | | CLAUDE CONFIG DIR Default: $HOME/.claude-2 | | | CC AUTO SUMMARY=1 Enable Gemini-based prev-session auto-summary on ls | | | CLAUDE CMD Underlying CLI command default: claude | | | CMD NAME Display name in help text default: basename $0 | | | set -euo pipefail | | | CLAUDE CMD="${CLAUDE CMD:-$HOME/.local/bin/claude}" | | | CMD NAME="${CMD NAME:-$ basename "$0" }" | | | CLAUDE DIR="${CLAUDE CONFIG DIR:-$HOME/.claude-2}" | | | export CLAUDE CONFIG DIR="$CLAUDE DIR" | | | Mirror the user's claude alias: write a profile marker so other tools | | | can detect which profile claude-1 / claude-2 is active in this tty. | | | write profile marker { | | | local profile="${CLAUDE DIR /.}" ~/.claude-2 - claude-2 | | | local tty id | | | tty id=$ { tty 2 /dev/null || true; } | tr '/' ' ' | | | -n "$tty id" && "$tty id" = "not a tty" && echo "$profile" "/tmp/.claude profile $tty id" 2 /dev/null || true | | | } | | | write profile marker | | | NAMES DIR="$CLAUDE DIR/session-names" | | | PROJECTS DIR="$CLAUDE DIR/projects" | | | SUMMARIES DIR="$CLAUDE DIR/session-summaries" | | | mkdir -p "$NAMES DIR" "$SUMMARIES DIR" | | | Encode a path to Claude Code's project directory name | | | /Users/Z1nk - -Users-Z1nk | | | encode project path { | | | echo "$1" | sed -e 's|/|-|g' -e 's| |-|g' | | | } | | | current project id { | | | encode project path "$PWD" | | | } | | | names file { | | | local project id="${1:-default}" | | | echo "$NAMES DIR/$project id.json" | | | } | | | get name { | | | local project id="$1" session id="$2" | | | local nf | | | nf=$ names file "$project id" | | | -f "$nf" && python3 -c " | | | import json, sys | | | d = json.load open sys.argv 1 | | | print d.get sys.argv 2 , '' | | | " "$nf" "$session id" 2 /dev/null || echo "" | | | } | | | set name { | | | local project id="$1" session id="$2" name="$3" | | | local nf | | | nf=$ names file "$project id" | | | python3 -c " | | | import json, os, sys | | | nf, sid, name = sys.argv 1 , sys.argv 2 , sys.argv 3 | | | d = {} | | | if os.path.exists nf : | | | d = json.load open nf | | | d sid = name | | | json.dump d, open nf, 'w' , indent=2, ensure ascii=False | | | " "$nf" "$session id" "$name" | | | } | | | rm name { | | | local project id="$1" session id="$2" | | | local nf | | | nf=$ names file "$project id" | | | -f "$nf" && python3 -c " | | | import json, os, sys | | | nf, sid = sys.argv 1 , sys.argv 2 | | | d = json.load open nf | | | d.pop sid, None | | | json.dump d, open nf, 'w' , indent=2, ensure ascii=False | | | " "$nf" "$session id" 2 /dev/null | | | } | | | Opt-in: generate Gemini summary for previous session in background | | | generate summary for latest { | | | "${CC AUTO SUMMARY:-0}" = "1" || return 0 | | | command -v gemini /dev/null 2 &1 || return 0 | | | python3 - "$PWD" "$PROJECTS DIR" "$SUMMARIES DIR" <<'PYEOF' & | | | import json, os, sys, glob, subprocess | | | cwd, projects dir, summaries dir = sys.argv 1 , sys.argv 2 , sys.argv 3 | | | project id = cwd.replace "/", "-" .replace " ", "-" | | | project dir = os.path.join projects dir, project id | | | if not os.path.isdir project dir : | | | sys.exit 0 | | | sessions = | | | for f in glob.glob os.path.join project dir, " .jsonl" : | | | sid = os.path.basename f .replace ".jsonl", "" | | | sessions.append sid, f, os.path.getmtime f | | | sessions.sort key=lambda x: x 2 , reverse=True | | | for sid, fpath, in sessions 1:2 : | | | summary file = os.path.join summaries dir, f"{sid}.txt" | | | if os.path.exists summary file : | | | continue | | | user msgs = | | | try: | | | with open fpath as fh: | | | for line in fh: | | | line = line.strip | | | if not line: | | | continue | | | try: | | | record = json.loads line | | | if record.get "type" = "user": | | | continue | | | msg = record.get "message", {} | | | content = msg.get "content", "" | | | text = "" | | | if isinstance content, str : | | | text = content.strip | | | elif isinstance content, list : | | | for c in content: | | | if isinstance c, dict and c.get "type" == "text": | | | t = c.get "text", "" .strip | | | if t: | | | text = t | | | break | | | if text: | | | user msgs.append text :500 | | | except Exception: | | | continue | | | except Exception: | | | continue | | | if len user msgs < 2: | | | continue | | | selected = user msgs :5 + user msgs -5: if len user msgs 10 else user msgs | | | prompt text = "Summarize this conversation in one short sentence max 50 chars, same language as the conversation . Just output the summary, nothing else.\n\n" | | | for i, m in enumerate selected, 1 : | | | prompt text += f"User message {i}: {m}\n\n" | | | try: | | | result = subprocess.run | | | "gemini", "-p", prompt text , | | | capture output=True, text=True, timeout=15 | | | | | | summary = result.stdout.strip .replace "\n", " " :80 | | | if summary and "error" not in summary.lower :20 : | | | with open summary file, "w" as sf: | | | sf.write summary | | | except Exception: | | | pass | | | PYEOF | | | } | | | cmd list { | | | local all projects=false | | | "${1:-}" = "-a" && all projects=true | | | python3 - "$all projects" "$PWD" "$PROJECTS DIR" "$NAMES DIR" "$SUMMARIES DIR" <<'PYEOF' | | | import json, os, sys, glob | | | from datetime import datetime, timezone | | | all projects = sys.argv 1 == "true" | | | cwd = sys.argv 2 | | | projects dir = sys.argv 3 | | | names dir = sys.argv 4 | | | summaries dir = sys.argv 5 | | | home = os.path.expanduser "~" | | | desktop sessions dir = os.path.join home, "Library", "Application Support", "Claude", "claude-code-sessions" | | | def encode path p : | | | return p.replace "/", "-" .replace " ", "-" | | | def decode path encoded : | | | if not encoded.startswith "-" : | | | return encoded | | | parts = encoded 1: .split "-" | | | result = "" | | | i = 0 | | | while i < len parts : | | | for j in range len parts , i, -1 : | | | candidate = result + "/" + "-".join parts i:j | | | if os.path.isdir candidate or j == i + 1: | | | result = candidate | | | i = j | | | break | | | return result if result else "/" + encoded 1: .replace "-", "/" | | | def get display path encoded : | | | decoded = decode path encoded | | | if decoded.startswith home : | | | return "~" + decoded len home : | | | elif decoded == "/": | | | return "/" | | | return decoded | | | def load desktop titles : | | | titles = {} | | | if not os.path.isdir desktop sessions dir : | | | return titles | | | for f in glob.glob os.path.join desktop sessions dir, " ", " ", " .json" : | | | try: | | | d = json.load open f | | | cli sid = d.get "cliSessionId", "" | | | title = d.get "title", "" | | | if cli sid and title: | | | titles cli sid = title | | | except Exception: | | | continue | | | return titles | | | desktop titles = load desktop titles | | | current project = encode path cwd | | | sessions = | | | for project dir in sorted glob.glob os.path.join projects dir, " " : | | | if not os.path.isdir project dir : | | | continue | | | project id = os.path.basename project dir | | | if not all projects and project id = current project: | | | continue | | | nf = os.path.join names dir, f"{project id}.json" | | | names = {} | | | if os.path.exists nf : | | | try: | | | names = json.load open nf | | | except Exception: | | | pass | | | display path = get display path project id | | | for f in glob.glob os.path.join project dir, " .jsonl" : | | | fname = os.path.basename f | | | sid = fname.replace ".jsonl", "" | | | msg count = 0 | | | last user msg = "" | | | last time = "" | | | try: | | | with open f as fh: | | | for line in fh: | | | line = line.strip | | | if not line: | | | continue | | | try: | | | record = json.loads line | | | rtype = record.get "type", "" | | | ts = record.get "timestamp", "" | | | if ts: | | | last time = ts | | | if rtype == "user": | | | msg count += 1 | | | msg = record.get "message", {} | | | content = msg.get "content", "" | | | text = "" | | | if isinstance content, str : | | | text = content.replace "\n", " " .strip | | | elif isinstance content, list : | | | for c in content: | | | if isinstance c, dict and c.get "type" == "text": | | | text = c.get "text", "" .replace "\n", " " .strip | | | if text: | | | break | | | if text: | | | last user msg = text :50 | | | elif rtype == "assistant": | | | msg count += 1 | | | except Exception: | | | continue | | | except Exception: | | | continue | | | if msg count == 0: | | | continue | | | custom name = desktop titles.get sid, "" or names.get sid, "" | | | summary = "" | | | sf = os.path.join summaries dir, f"{sid}.txt" | | | if os.path.exists sf : | | | try: | | | summary = open sf .read .strip :80 | | | except Exception: | | | pass | | | time str = "" | | | if last time: | | | try: | | | if isinstance last time, int, float : | | | dt = datetime.fromtimestamp last time / 1000, tz=timezone.utc | | | else: | | | dt = datetime.fromisoformat str last time .replace "Z", "+00:00" | | | now = datetime.now timezone.utc | | | diff = now - dt | | | if diff.days 0: | | | time str = f"{diff.days}d ago" | | | elif diff.seconds 3600: | | | time str = f"{diff.seconds // 3600}h ago" | | | else: | | | time str = f"{diff.seconds // 60}m ago" | | | except Exception: | | | time str = str last time :16 | | | sessions.append { | | | "project": project id, | | | "project path": display path, | | | "sid": sid, | | | "name": custom name, | | | "summary": summary, | | | "last msg": last user msg, | | | "time": time str, | | | "sort time": last time, | | | "msgs": msg count, | | | } | | | sessions.sort key=lambda s: s "sort time" if s "sort time" else "", reverse=True | | | if not sessions: | | | print " No sessions found." | | | sys.exit 0 | | | current proj = "" | | | for i, s in enumerate sessions, 1 : | | | if all projects and s "project" = current proj: | | | current proj = s "project" | | | print f" \033 0;33m{s 'project path' }\033 0m" | | | proj = f"\033 0;33m{s 'project path' }\033 0m" if not all projects else "" | | | preview = s "summary" or s "last msg" or " empty " | | | line = f" {i: 3}. {s 'time' : 8} {s 'msgs' : 3} msgs" | | | if not all projects: | | | line += f" {proj}" | | | if s "name" : | | | line += f" \033 1;36m{s 'name' }\033 0m" | | | if s "summary" : | | | line += f" {s 'summary' :40 } " | | | else: | | | line += f" {preview}" | | | print line | | | PYEOF | | | } | | | resolve session { | | | local query="$1" | | | local all flag="${2:-}" | | | python3 - "$query" "$PWD" "$all flag" "$PROJECTS DIR" "$NAMES DIR" <<'PYEOF' | head -1 | | | import json, os, sys, glob | | | query = sys.argv 1 | | | cwd = sys.argv 2 | | | all flag = sys.argv 3 | | | projects dir = sys.argv 4 | | | names dir = sys.argv 5 | | | def encode path p : | | | return p.replace "/", "-" .replace " ", "-" | | | current project = encode path cwd | | | sessions = | | | for project dir in sorted glob.glob os.path.join projects dir, " " : | | | if not os.path.isdir project dir : | | | continue | | | project id = os.path.basename project dir | | | if all flag = "-a" and project id = current project: | | | continue | | | nf = os.path.join names dir, f"{project id}.json" | | | names = {} | | | if os.path.exists nf : | | | try: | | | names = json.load open nf | | | except Exception: | | | pass | | | for f in glob.glob os.path.join project dir, " .jsonl" : | | | sid = os.path.basename f .replace ".jsonl", "" | | | msg count = 0 | | | last time = "" | | | try: | | | with open f as fh: | | | for line in fh: | | | line = line.strip | | | if not line: | | | continue | | | try: | | | r = json.loads line | | | if r.get "type" in "user", "assistant" : | | | msg count += 1 | | | ts = r.get "timestamp", "" | | | if ts: | | | last time = ts | | | except Exception: | | | continue | | | except Exception: | | | continue | | | if msg count == 0: | | | continue | | | custom name = names.get sid, "" | | | sessions.append {"sid": sid, "name": custom name, "project": project id, "sort time": last time} | | | sessions.sort key=lambda s: s "sort time" if s "sort time" else "", reverse=True | | | try: | | | idx = int query - 1 | | | if 0 <= idx < len sessions : | | | print sessions idx "sid" | | | sys.exit 0 | | | except ValueError: | | | pass | | | Match by session ID full UUID or unambiguous prefix, min 4 chars | | | if len query = 4 and all c in "0123456789abcdef-" for c in query.lower : | | | q = query.lower | | | exact = s for s in sessions if s "sid" .lower == q | | | if exact: | | | print exact 0 "sid" | | | sys.exit 0 | | | prefix = s for s in sessions if s "sid" .lower .startswith q | | | if len prefix == 1: | | | print prefix 0 "sid" | | | sys.exit 0 | | | if len prefix 1: | | | print f"ERROR: session id prefix '{query}' is ambiguous {len prefix } matches ", file=sys.stderr | | | sys.exit 1 | | | for s in sessions: | | | if s "name" == query: | | | print s "sid" | | | sys.exit 0 | | | for s in sessions: | | | if s "name" and query.lower in s "name" .lower : | | | print s "sid" | | | sys.exit 0 | | | print f"ERROR: No session found matching '{query}'", file=sys.stderr | | | sys.exit 1 | | | PYEOF | | | } | | | resolve project for session { | | | local session id="$1" | | | python3 -c " | | | import os, glob, sys | | | sid = sys.argv 1 | | | projects dir = sys.argv 2 | | | for f in glob.glob os.path.join projects dir, ' ', sid + '.jsonl' : | | | print os.path.basename os.path.dirname f | | | break | | | " "$session id" "$PROJECTS DIR" 2 /dev/null | | | } | | | find newest session after { | | | local ts="$1" | | | python3 - "$ts" "$PWD" "$PROJECTS DIR" <<'PYEOF' | head -1 | | | import os, sys, glob | | | ts = int sys.argv 1 | | | cwd = sys.argv 2 | | | projects dir = sys.argv 3 | | | project id = cwd.replace "/", "-" .replace " ", "-" | | | project dir = os.path.join projects dir, project id | | | newest = None | | | newest time = ts | | | if os.path.isdir project dir : | | | for f in glob.glob os.path.join project dir, " .jsonl" : | | | try: | | | mtime = int os.path.getmtime f 1000 | | | if mtime ts and mtime newest time: | | | newest = os.path.basename f .replace ".jsonl", "" | | | newest time = mtime | | | except Exception: | | | continue | | | if newest: | | | print newest | | | PYEOF | | | } | | | launch and name { | | | local session name="$1" | | | shift | | | local ts | | | ts=$ python3 -c "import time; print int time.time 1000 " | | | "$CLAUDE CMD" "$@" | | | local sid | | | sid=$ find newest session after "$ts" | | | if -n "$sid" && -n "$session name" ; then | | | local project id | | | project id=$ resolve project for session "$sid" | | | if -n "$project id" ; then | | | set name "$project id" "$sid" "$session name" | | | echo "Session saved as: $session name" | | | fi | | | fi | | | } | | | case "${1:-}" in | | | ls | | | generate summary for latest | | | cmd list "" | | | ;; | | | lsa | | | generate summary for latest | | | cmd list "-a" | | | ;; | | | r|resume | | | -z "${2:-}" && echo "Usage: $CMD NAME r <name|index " && exit 1 | | | Numeric index resolves in current-project scope matches cc ls ; | | | names/IDs resolve cross-project matches cc lsa . | | | if "$2" =~ ^ 0-9 +$ ; then | | | sid=$ resolve session "$2" "" | | | else | | | sid=$ resolve session "$2" "-a" | | | fi | | | if -n "$sid" ; then | | | exec "$CLAUDE CMD" --resume "$sid" | | | fi | | | ;; | | | rn|rename | | | { -z "${2:-}" || -z "${3:-}" ; } && echo "Usage: $CMD NAME rn <index <name " && exit 1 | | | target="$2" | | | shift 2 | | | sid=$ resolve session "$target" "-a" | | | if -n "$sid" ; then | | | project id=$ resolve project for session "$sid" | | | set name "$project id" "$sid" "$ " | | | echo "Named session as: $ " | | | fi | | | ;; | | | rm|delete | | | -z "${2:-}" && echo "Usage: $CMD NAME rm <name|index|session-id " && exit 1 | | | sid=$ resolve session "$2" "-a" 2 /dev/null | | | Fallback: treat arg as a raw session id and locate the file on disk | | | if -z "$sid" && "$2" =~ ^ 0-9a-fA-F- {4,}$ ; then | | | match=$ find "$PROJECTS DIR" -maxdepth 2 -name "$2 .jsonl" 2 /dev/null | | | count=$ printf "%s\n" "$match" | grep -c . | | | if "$count" = "1" ; then | | | sid=$ basename "$match" .jsonl | | | elif "$count" -gt 1 ; then | | | echo "ERROR: session id '$2' matches $count files" &2 | | | exit 1 | | | fi | | | fi | | | if -n "$sid" ; then | | | project id=$ resolve project for session "$sid" | | | session file="$PROJECTS DIR/$project id/$sid.jsonl" | | | session dir="$PROJECTS DIR/$project id/$sid" | | | -f "$session file" && trash "$session file" | | | -d "$session dir" && trash "$session dir" | | | -n "$project id" && rm name "$project id" "$sid" | | | echo "Trashed session: $sid" | | | else | | | echo "ERROR: No session found matching '$2'" &2 | | | exit 1 | | | fi | | | ;; | | | clear | | | count=$ find "$PROJECTS DIR" -name " .jsonl" 2 /dev/null | wc -l | tr -d ' ' | | | echo "This will move $count session file s and all name maps to the Trash." | | | echo -n "Type 'yes' to confirm: " | | | read -r confirm | | | if "$confirm" = "yes" ; then | | | Collect files into an array so trash gets explicit paths | | | while IFS= read -r f; do | | | -n "$f" && trash "$f" | | | done < < find "$PROJECTS DIR" -name " .jsonl" 2 /dev/null | | | for nf in "$NAMES DIR"/ .json; do | | | -f "$nf" && trash "$nf" | | | done | | | echo "All sessions trashed." | | | else | | | echo "Cancelled." | | | fi | | | ;; | | | n|new | | | -z "${2:-}" && echo "Usage: $CMD NAME n <name " && exit 1 | | | shift | | | launch and name "$ " | | | ;; | | | help|-h|--help | | | cat <<EOF | | | $CMD NAME - Claude Code wrapper with session naming | | | Usage: | | | $CMD NAME n <name Start a new session with a name | | | $CMD NAME ls List sessions current project | | | $CMD NAME lsa List sessions across all projects | | | $CMD NAME r <name|index Resume session numeric index = current project, like 'ls'; | | | name/UUID = cross-project, like 'lsa' | | | $CMD NAME rn <index <name Rename a session | | | $CMD NAME rm <name|index|id Trash a session by name, list index, or session UUID/prefix | | | $CMD NAME clear Trash all sessions with confirmation | | | $CMD NAME help Show this help | | | Note: sessions are scoped per profile via CLAUDE CONFIG DIR. Two profiles | | | e.g. ~/.claude and ~/.claude-2 have independent session lists — switching | | | profile changes what 'ls' and 'r <index ' see. | | | Env: | | | CLAUDE CONFIG DIR=$CLAUDE DIR | | | CC AUTO SUMMARY=${CC AUTO SUMMARY:-0} set to 1 to enable Gemini summaries | | | EOF | | | ;; | | | "" | | | No args: behave like a plain claude launcher matches former alias | | | exec "$CLAUDE CMD" | | | ;; | | | | | | echo "Unknown command: $1 try '$CMD NAME help' " && exit 1 | | | ;; | | | esac |