{"id":50182150,"url":"https://github.com/remvisual/claude-workspace-snapshot","last_synced_at":"2026-05-25T07:05:25.161Z","repository":{"id":347706751,"uuid":"1194981122","full_name":"REMvisual/claude-workspace-snapshot","owner":"REMvisual","description":"Never lose your Claude Code tabs again. Snapshot and restore sessions as color-coded Windows Terminal tabs.","archived":false,"fork":false,"pushed_at":"2026-04-04T06:30:32.000Z","size":75,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-20T01:03:38.807Z","etag":null,"topics":["anthropic-claude","claude-code","developer-tools","powershell","productivity","session-management","windows-terminal","workspace-management"],"latest_commit_sha":null,"homepage":"https://remrepo.com","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/REMvisual.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-29T03:56:52.000Z","updated_at":"2026-04-08T10:00:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/REMvisual/claude-workspace-snapshot","commit_stats":null,"previous_names":["remvisual/claude-workspace-snapshot"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/REMvisual/claude-workspace-snapshot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/REMvisual%2Fclaude-workspace-snapshot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/REMvisual%2Fclaude-workspace-snapshot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/REMvisual%2Fclaude-workspace-snapshot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/REMvisual%2Fclaude-workspace-snapshot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/REMvisual","download_url":"https://codeload.github.com/REMvisual/claude-workspace-snapshot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/REMvisual%2Fclaude-workspace-snapshot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33464014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T06:32:55.349Z","status":"ssl_error","status_checked_at":"2026-05-25T06:32:35.322Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic-claude","claude-code","developer-tools","powershell","productivity","session-management","windows-terminal","workspace-management"],"created_at":"2026-05-25T07:04:56.901Z","updated_at":"2026-05-25T07:05:25.149Z","avatar_url":"https://github.com/REMvisual.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/banner.svg\" alt=\"claude-workspace-snapshot\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\n[![Download Latest](https://img.shields.io/github/v/release/REMvisual/claude-workspace-snapshot?style=for-the-badge\u0026label=Download\u0026color=blue)](https://github.com/REMvisual/claude-handoff/releases/latest)\n![Views](https://komarev.com/ghpvc/?username=REMvisualclaude-workspace-snapshot\u0026label=Views\u0026color=brightgreen\u0026style=for-the-badge)\n\n\n\n## Why This Exists\n\nYou 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.\n\nThis tool fixes that. Two scripts. One saves your workspace, the other brings it back.\n\n## Before / After\n\n```\nBEFORE:  Restart -\u003e lose 15 tabs -\u003e manually find UUIDs -\u003e type claude --resume for each one\nAFTER:   Restart -\u003e double-click restore.bat -\u003e all tabs back in 5 seconds\n```\n\n## Quick Demo\n\n```\n1. Work across multiple projects in Claude Code\n2. Before shutdown:  run snapshot.bat\n3. After restart:    run restore.bat  -\u003e  everything's back\n```\n\nThat's it. Your sessions come back in the right directories, with the right tab names, grouped by project, color-coded.\n\n## Install\n\n**PowerShell (recommended):**\n\n```powershell\nirm https://raw.githubusercontent.com/REMvisual/claude-workspace-snapshot/main/install.ps1 | iex\n```\n\n**Git Bash / WSL:**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/REMvisual/claude-workspace-snapshot/main/install.sh | bash\n```\n\n**Manual:**\n\n```bash\ngit clone https://github.com/REMvisual/claude-workspace-snapshot.git\ncp claude-workspace-snapshot/scripts/* ~/.claude/scripts/\n```\n\n## Usage\n\n### Snapshot (before shutdown)\n\nDouble-click `workspace-snapshot.bat` or run it from terminal:\n\n```\n~/.claude/scripts/workspace-snapshot.bat\n```\n\nIt finds your live sessions, groups them by project, and saves everything to `~/.claude/workspace.json`:\n\n```\n  WORKSPACE SNAPSHOT (live detection)\n  13 live sessions (8 from processes, 5 from file activity)\n\n  --- skywatch (#4A9BD9) ---\n  1. Add hourly forecast caching to reduce API calls [P] Mar 28 14:25\n  2. Fix timezone handling in weather alerts           [F] Mar 28 14:10\n  --- taskflow-api (#E67E22) ---\n  3. Fix race condition in concurrent task assignment  [P] Mar 28 14:20\n  4. Add WebSocket notifications for task updates      [F] Mar 28 13:45\n\n  Save all? [Y/n] or enter numbers (e.g. 1,3,5)\n```\n\n### Restore (after restart)\n\nDouble-click `workspace-restore.bat` or run it from terminal:\n\n```\n~/.claude/scripts/workspace-restore.bat\n```\n\nIt rebuilds your Windows Terminal layout -- one window per project, each tab resuming its session with the correct directory, name, and color:\n\n```\n  WORKSPACE RESTORE\n  Snapshot: 2026-03-28 14:30 (2h ago)\n\n  Window 1: skywatch (#4A9BD9) -- 2 tab(s)\n    1. skywatch: Add hourly forecast caching to reduc...\n    2. skywatch: Fix timezone handling in weather aler...\n  Window 2: taskflow-api (#E67E22) -- 2 tab(s)\n    3. taskflow-api: Fix race condition in concurrent ...\n    4. taskflow-api: Add WebSocket notifications for t...\n\n  Options:\n    Enter    = restore all windows\n    w1,w2    = restore specific windows (e.g. w1,w3)\n    1,3,5    = restore specific tabs (e.g. 1,3,5)\n    n        = cancel\n```\n\n## How It Works\n\n1. **Detects sessions** -- scans running `claude.exe` processes and recently active session files to find every live session\n2. **Extracts metadata** -- reads the session summary, working directory, and git branch from each session's data\n3. **Groups and colors** -- clusters sessions by project and assigns each project a stable color based on its name\n4. **Saves to JSON** -- writes everything to `~/.claude/workspace.json` (editable if you want to rename tabs or change colors)\n5. **Restores via Windows Terminal** -- builds `wt.exe` commands with the right title, color, directory, and `--resume` flag for each tab\n\n## Options\n\n| Command | Description |\n|---------|-------------|\n| `workspace-snapshot.bat` | Snapshot with default 30-minute activity window |\n| `workspace-snapshot.bat 60` | Snapshot with 60-minute window (catches idle sessions) |\n| `workspace-restore.bat` | Interactive restore with session/window picker |\n| `workspace-restore.bat --all` | Restore everything without prompting |\n\n## Editing Your Workspace\n\nAfter snapshotting, edit `~/.claude/workspace.json` directly to:\n\n- Rename tabs (change the `tabName` field)\n- Change tab colors (set `tabColor` to any `#RRGGBB` value)\n- Rearrange or remove sessions\n\n## Requirements\n\n- Windows 10 or 11\n- [Windows Terminal](https://aka.ms/terminal) (wt.exe)\n- PowerShell 5.1+ (built into Windows 10+)\n- [Claude Code CLI](https://claude.ai/code) installed and on PATH\n\n## Uninstall\n\n```powershell\n~/.claude/scripts/uninstall.ps1\n```\n\nOr remove the files manually:\n\n```powershell\nrm ~/.claude/scripts/workspace-snapshot.ps1\nrm ~/.claude/scripts/workspace-snapshot.bat\nrm ~/.claude/scripts/workspace-restore.ps1\nrm ~/.claude/scripts/workspace-restore.bat\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. PRs are welcome.\n\n## License\n\n[MIT](LICENSE)\n\n---\n\nIf this tool saved you time, [give it a star](https://github.com/REMvisual/claude-workspace-snapshot). It helps others find it.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-compatible-blueviolet.svg)](https://claude.ai/code)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremvisual%2Fclaude-workspace-snapshot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fremvisual%2Fclaude-workspace-snapshot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremvisual%2Fclaude-workspace-snapshot/lists"}