claude-workspace-snapshot

[](https://github.com/REMvisual/claude-handoff/releases/latest)

Why This Exists

You run multiple Claude Code sessions across different projects. You restart your machine. Now every tab is gone. The built-in `claude --resume` command exists, but it needs 36-character UUIDs that you have to dig out of a wall of text. For each session. One at a time.

This tool fixes that. Two scripts. One saves your workspace, the other brings it back.

Before / After

BEFORE:  Restart -> lose 15 tabs -> manually find UUIDs -> type claude --resume for each one
AFTER:   Restart -> double-click restore.bat -> all tabs back in 5 seconds

Quick Demo

1. Work across multiple projects in Claude Code
2. Before shutdown:  run snapshot.bat
3. After restart:    run restore.bat  ->  everything's back

That's it. Your sessions come back in the right directories, with the right tab names, grouped by project, color-coded.

Install

**PowerShell (recommended):**

irm https://raw.githubusercontent.com/REMvisual/claude-workspace-snapshot/main/install.ps1 | iex

**Git Bash / WSL:**

curl -fsSL https://raw.githubusercontent.com/REMvisual/claude-workspace-snapshot/main/install.sh | bash

**Manual:**

git clone https://github.com/REMvisual/claude-workspace-snapshot.git
cp claude-workspace-snapshot/scripts/* ~/.claude/scripts/

Usage

Snapshot (before shutdown)

Double-click `workspace-snapshot.bat` or run it from terminal:

~/.claude/scripts/workspace-snapshot.bat

It finds your live sessions, groups them by project, and saves everything to `~/.claude/workspace.json`:

  WORKSPACE SNAPSHOT (live detection)
  13 live sessions (8 from processes, 5 from file activity)

  --- skywatch (#4A9BD9) ---
  1. Add hourly forecast caching to reduce API calls [P] Mar 28 14:25
  2. Fix timezone handling in weather alerts           [F] Mar 28 14:10
  --- taskflow-api (#E67E22) ---

...