convez.ai
PluginAutomaçãoIntermediário
REMvisual

Claude Workspace Snapshot

REMvisual/claude-workspace-snapshot

Snapshot e restore de sessões Claude em abas do Terminal com um clique

Ver no GitHub
BomPluginScore · de 0 a 100

Plugin PowerShell que captura e restaura suas sessões do Claude Code como abas color-coded no Windows Terminal. Elimina a necessidade de digitar UUIDs manualmente após reiniciar a máquina, salvando e reconstruindo o workspace inteiro em segundos.

Instalação

$npx convez-ai REMvisual/claude-workspace-snapshot

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
1
Acompanhando
0
Saúde
71%
Último commit
há 1 mês
Versão
v1.3.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Recuperar múltiplas sessões Claude após reinicialização da máquina
  • Organizar e gerenciar workspaces por projeto com código de cores
  • Automatizar a restauração de ambientes de desenvolvimento

Veredito

Ferramenta prática que resolve um problema real do fluxo de trabalho com Claude Code no Windows. Implementação sólida em PowerShell, com boa UX e detecção automática de sessões ativas.

README

A tradução para o português deste README ainda está na fila.

Download Latest Views

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) ---
  3. Fix race condition in concurrent task assignment  [P] Mar 28 14:20
  4. Add WebSocket notifications for task updates      [F] Mar 28 13:45

  Save all? [Y/n] or enter numbers (e.g. 1,3,5)

Restore (after restart)

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

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

It rebuilds your Windows Terminal layout -- one window per project, each tab resuming its session with the correct directory, name, and color:

  WORKSPACE RESTORE
  Snapshot: 2026-03-28 14:30 (2h ago)

  Window 1: skywatch (#4A9BD9) -- 2 tab(s)
    1. skywatch: Add hourly forecast caching to reduc...
    2. skywatch: Fix timezone handling in weather aler...
  Window 2: taskflow-api (#E67E22) -- 2 tab(s)
    3. taskflow-api: Fix race condition in concurrent ...
    4. taskflow-api: Add WebSocket notifications for t...

  Options:
    Enter    = restore all windows
    w1,w2    = restore specific windows (e.g. w1,w3)
    1,3,5    = restore specific tabs (e.g. 1,3,5)
    n        = cancel

How It Works

  1. Detects sessions -- scans running claude.exe processes and recently active session files to find every live session
  2. Extracts metadata -- reads the session summary, working directory, and git branch from each session's data
  3. Groups and colors -- clusters sessions by project and assigns each project a stable color based on its name
  4. Saves to JSON -- writes everything to ~/.claude/workspace.json (editable if you want to rename tabs or change colors)
  5. Restores via Windows Terminal -- builds wt.exe commands with the right title, color, directory, and --resume flag for each tab

Options

CommandDescription
workspace-snapshot.batSnapshot with default 30-minute activity window
workspace-snapshot.bat 60Snapshot with 60-minute window (catches idle sessions)
workspace-restore.batInteractive restore with session/window picker
workspace-restore.bat --allRestore everything without prompting

Editing Your Workspace

After snapshotting, edit ~/.claude/workspace.json directly to:

  • Rename tabs (change the tabName field)
  • Change tab colors (set tabColor to any #RRGGBB value)
  • Rearrange or remove sessions

Requirements

Uninstall

~/.claude/scripts/uninstall.ps1

Or remove the files manually:

rm ~/.claude/scripts/workspace-snapshot.ps1
rm ~/.claude/scripts/workspace-snapshot.bat
rm ~/.claude/scripts/workspace-restore.ps1
rm ~/.claude/scripts/workspace-restore.bat

Contributing

See CONTRIBUTING.md for guidelines. PRs are welcome.

License

MIT


If this tool saved you time, give it a star. It helps others find it.

License: MIT Claude Code PRs Welcome

Ver o original no GitHub

Bom para

Relacionados