Claude Code Plugins

Community-maintained marketplace

Feedback

branch-session

@buddyh/claude-code-skills
1
0

Branch the current Claude Code session into a new tmux session using --resume. Creates a parallel conversation that can diverge independently. Use when you want to explore an alternative approach without losing your current context.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name branch-session
description Branch the current Claude Code session into a new tmux session using --resume. Creates a parallel conversation that can diverge independently. Use when you want to explore an alternative approach without losing your current context.

Branch Session

Overview

Create a "branch" of the current Claude Code conversation by spawning a new tmux session that resumes from the same session ID. Both sessions can then diverge independently.

Workflow

Step 1: Get Current Session ID

Find the active Claude Code session by:

  1. Get current working directory
  2. Convert to Claude project path format:
    # /home/user/projects/myapp -> -home-user-projects-myapp
PROJECT_PATH=$(echo "$PWD" | sed 's|/|-|g' | sed 's|^-||')
  3. Find most recently modified session file:
    SESSION_FILE=$(ls -t ~/.claude/projects/$PROJECT_PATH/*.jsonl 2>/dev/null | head -1)
SESSION_ID=$(basename "$SESSION_FILE" .jsonl)

Step 2: Generate Branch Name

Create a unique session name:

SHORT_ID=$(echo "$SESSION_ID" | cut -c1-5)
TIMESTAMP=$(date +%H%M)
BRANCH_NAME="branch-${SHORT_ID}-${TIMESTAMP}"

Step 3: Execute Branch

Run the branch script:

~/.claude/skills/branch-session/scripts/branch_session.sh "$PWD" "$SESSION_ID" "$BRANCH_NAME"

Step 4: Confirm

Report to user:

Branched session: branch-a1b2c-1508
Directory: /home/user/projects/myapp
Resuming: a1b2c3d4-da03-4ece-8625-582be89f6dff

To attach: tmux attach -t branch-a1b2c-1508

Quick Reference

Invocation: /branch

Session naming: branch-<first-5-chars-of-id>-<HHMM>

Use cases:

  • Explore alternative implementation approaches
  • Test something risky without losing progress
  • Split work into parallel tracks

Setup

Make the script executable (one-time):

chmod +x ~/.claude/skills/branch-session/scripts/branch_session.sh

Requirements

  • tmux installed and running
  • Claude Code CLI (claude command available)
  • Active Claude Code session to branch from

Resources

scripts/

  • branch_session.sh - Creates tmux session and runs claude --resume