Skip to content

srives/WinClaudeCodeForker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Claude Code Session Manager v2.0.1

A visual session manager for Claude Code CLI with fork/continue workflows and background watermarks.

Platform Status Terminal Support
Windows βœ… Stable Windows Terminal
Linux 🚧 In Progress Kitty, Konsole, WSL

Windows Version

A Claude Code Session Manager CLI tool for Windows Terminal Users. Download WinClaudeForker.exe

Visual session management for Claude Code CLI Never lose track of your conversations. See all your sessions, fork with confidence, track your costs.

Main Menu


🎯 The Problem

Working with multiple Claude Code sessions? Can't remember which terminal is which project? No visual way to track your conversations? Wondering how much you're spending on API calls?

✨ The Solution

Windows Claude Code Forker gives you instant visual context for all your Claude sessions:

  • πŸ“‹ See all sessions at a glance with sortable columns
  • 🍴 Fork conversations with custom Windows Terminal backgrounds
  • πŸ’° Track costs per session with detailed analytics
  • 🌿 Git branch awareness in every session
  • ⚑ Lightning-fast arrow-key navigation
  • 🎨 Custom backgrounds showing session context

Session with Watermark Each forked session gets a unique background: session name, parent, git branch, and model


πŸš€ Quick Install

Option 1: Installer (Recommended)

  1. Download WinClaudeForker.exe
  2. Run the installer
  3. Launch "Claude Session Manager" from your desktop

Option 2: Manual Install

# Create directory
New-Item -ItemType Directory -Path "$env:USERPROFILE\.claude-menu" -Force

# Copy script
Copy-Item "Claude-Menu.ps1" "$env:USERPROFILE\.claude-menu\"

# Create desktop shortcut
$WshShell = New-Object -ComObject WScript.Shell
$Shortcut = $WshShell.CreateShortcut("$env:USERPROFILE\Desktop\Claude Session Manager.lnk")
$Shortcut.TargetPath = "powershell.exe"
$Shortcut.Arguments = "-ExecutionPolicy Bypass -File `"$env:USERPROFILE\.claude-menu\Claude-Menu.ps1`""
$Shortcut.Save()

Requirements:

  • Windows 10/11
  • PowerShell 5.1+
  • Windows Terminal
  • Claude Code CLI

πŸ’‘ Key Features

Session Management

  • All Sessions Visible - Scans your entire drive for Claude sessions
  • Fork with Context - Branch conversations with custom Windows Terminal profiles
  • Archive & Notes - Tag sessions with notes, archive old conversations
  • Rename Anytime - Rename sessions and update all references automatically

Visual Intelligence

  • Custom Backgrounds - Each fork gets a unique background showing:
    • Session name
    • Parent session (if forked)
    • Git branch
    • AI model (Opus/Sonnet/Haiku)
    • Project directory
  • Activity Markers - See which sessions are active at a glance
  • Git Integration - Automatically detects and displays git branches

Cost Tracking

  • Per-Session Costs - See exactly how much each conversation costs
  • Token Analytics - Track input, output, and cache usage
  • Cache Hit Rates - Monitor prompt caching effectiveness
  • Total Spend - Know your total API spend across all sessions

Professional UX

  • Arrow Navigation - Instant keyboard navigation with ↑↓ keys
  • Dynamic Columns - Customize which columns appear (11 configurable columns)
  • Pagination - Handle hundreds of sessions with screen-aware pagination
  • Universal Defaults - Press Enter for default action in any menu
  • Silent Validation - 80 automated tests protect against bugs

⌨️ Quick Start

Launch & Navigate

Launch β†’ See all sessions β†’ Use ↑↓ to navigate β†’ Press Enter

πŸ“Š Cost Analysis

View detailed cost breakdown for all sessions:

Session                    Cost    Input   Output  Cached  Hit%
my-big-project            $15.23   2.5M    850K    12.3M   89%
frontend-refactor          $8.45   1.2M    420K     8.1M   87%
api-design                 $3.67   780K    190K     4.2M   84%
─────────────────────────────────────────────────────────────
TOTAL                     $27.35   4.5M    1.5M    24.6M   88%

Pricing: Claude Sonnet 4.5 ($3/$3.75/$0.30/$15 per 1M tokens)


🎨 Visual Context at a Glance

Main Menu Example

+──────────────────────────────────────────────────────────────────────+
| #  Active Model   Session           Messages  Created    Cost        |
+──────────────────────────────────────────────────────────────────────+
| 1  X      sonnet  my-project        45        01/18      $1.20       |
| 2         opus    [test-fork]       0         01/19      $0.00       |
| 3         haiku   api-redesign      28        01/17      $2.45       |
+──────────────────────────────────────────────────────────────────────+

New Session | Win Terminal Config | Hide Unnamed | Cost | Debug | Refresh | eXit

WIN TERMINAL Background Images Show

This is the key feature. Seeing a watermark on the Windows Terminal is the main idea of this product for me (a Windows user). The screen background image watermark has the following information:

  • Line 1: Session name (bold, 48pt)
  • Line 2: Forked from parent (if applicable)
  • Line 3: Git branch
  • Line 4: AI model (Opus/Sonnet/Haiku)
  • Line 5: Computer:User
  • Line 6: Full directory path

πŸ”§ Advanced Features

Column Configuration

Press G to customize which columns appear. Easter Egg: Press 1, 2, 3, 4, etc. to sort on a column.

Validation System

Built-in self-protection with 80 automated tests


πŸ› Troubleshooting

Sessions not appearing?

  • Press R to refresh
  • Enable debug mode with D
  • Check ~\.claude-menu\debug.log

Background images not showing?

  • Open Windows Terminal Settings
  • Select your Claude profile
  • Check Background Image path and opacity (30%)
  • Disable Acrylic effects if enabled

Script won't run?

powershell -ExecutionPolicy Bypass -File "Claude-Menu.ps1"

Need more help?


πŸ“š Documentation


πŸ’Ž What Makes This Special

Visual Watermarks on Every Session

Each Windows Terminal profile gets a custom background watermark showing:

  • Session name (large, readable at a glance)
  • Parent session (if forked)
  • Git branch (always know which branch you're on)
  • AI model (Opus/Sonnet/Haiku)
  • Directory path (never lose context)

Watermark Example Subtle watermark keeps you oriented without obscuring your work

Professional Quality

  • Enterprise-grade UX - Arrow navigation, silent input handling, universal defaults
  • 80 Automated Tests - Self-validating code protects against regressions
  • Comprehensive Error Handling - Graceful recovery from failures
  • Performance Optimized - Caching, pagination, instant response

Unique Features

  • Only professional-grade session manager for Claude Code
  • Cost tracking per session (know exactly what each conversation costs)
  • Visual fork tracking with custom watermark backgrounds
  • Windows Terminal deep integration (profiles, backgrounds, management)
  • Git branch awareness in every session
  • Context limit warnings before auto-compaction

Built with AI

This tool was created with Claude Code's help - a meta tool for managing Claude itself!

Demonstrates AI-assisted development achieving professional-grade quality in less than a week instead of months.


🀝 Contributing

Issues, suggestions, and contributions welcome!


Cost to Build (AI Cost vs. Hand Built Cost)

This software was built by a software engineer with decades of development experience using Claude Code AI. I built this in early 2026 on a whim for a side project at home. And, with most AI projects I work on (at work or at home) I like to ask AI to estimate cost and value, and then measure cost if I had built this without AI. I imagine we won't be asking this question in 2027 and beyond, as we are now in the transition to AI. So the question is interesting as we see the value of AI vs. traditional coding costs.

"What if this software was built by hand by one Senior Software Engineer, with no AI help?" See PRODUCT ANALYSIS for greater details

The following is Claude's own analysis/estimate of costs (I do think it is inflated, but it also gives a cost justification that is logical):

Windows Version (If Developed Traditionally):

  • Development cost: $175,000
  • Time to market: 6-8 months
  • Lines of code: ~9,000+ PowerShell
  • Features: 50+ with 80 automated tests

Linux Port (If Developed Traditionally):

  • Development cost: $35,000-50,000
  • Time to market: 2-3 months
  • Lines of code: ~2,500 Python
  • Market expansion: 1.6-2.5x (Linux/WSL users)

Total Product Value (Traditional Development):

  • Combined cost: $210,000-225,000
  • Total timeline: 8-11 months
  • Total LOC: ~11,500

🐧 Linux Version (In Progress)

A Linux port is under development with support for:

  • Terminal Emulators: Kitty, Konsole
  • WSL Support: Direct mode for WSL environments without GUI
  • Shell Support: Bash, Fish (Python core)
  • Image Generation: ImageMagick or Pillow

Quick Start (Linux/WSL)

cd linux/
bash install.sh
claude-menu

WSL Notes

In WSL without a display server, the manager runs in "direct mode" - sessions run in your current terminal. Background watermarks require GUI support (WSLg on Windows 11, or X server on Windows 10) with Kitty installed.

See Linux Documentation for full details.

Status: Core functionality working. Session discovery, debug logging, and WSL path detection being refined.


πŸ“ License

Created by S. Rives, 2026 See LICENSE for details.


πŸ”— Links


⭐ Star this repo if it makes your Claude Code workflow better!