{"id":28402727,"url":"https://github.com/life-experimentalist/global-save-state","last_synced_at":"2025-06-26T16:31:14.846Z","repository":{"id":295847709,"uuid":"991336813","full_name":"Life-Experimentalist/Global-Save-State","owner":"Life-Experimentalist","description":"VS Code Extension to dave your project at working save points.","archived":false,"fork":false,"pushed_at":"2025-05-31T12:41:44.000Z","size":25392,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-08T15:11:18.349Z","etag":null,"topics":["backup","checkpoint","develo","productivity","restore","save-state","timeline","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://life-experimentalist.github.io/Global-Save-State/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Life-Experimentalist.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-27T13:25:22.000Z","updated_at":"2025-05-31T12:43:15.000Z","dependencies_parsed_at":"2025-05-27T17:51:45.652Z","dependency_job_id":null,"html_url":"https://github.com/Life-Experimentalist/Global-Save-State","commit_stats":null,"previous_names":["life-experimentalist/global-save-state"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Life-Experimentalist/Global-Save-State","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Life-Experimentalist%2FGlobal-Save-State","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Life-Experimentalist%2FGlobal-Save-State/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Life-Experimentalist%2FGlobal-Save-State/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Life-Experimentalist%2FGlobal-Save-State/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Life-Experimentalist","download_url":"https://codeload.github.com/Life-Experimentalist/Global-Save-State/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Life-Experimentalist%2FGlobal-Save-State/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262102218,"owners_count":23259218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["backup","checkpoint","develo","productivity","restore","save-state","timeline","vscode","vscode-extension"],"created_at":"2025-06-01T16:07:35.261Z","updated_at":"2025-06-26T16:31:14.813Z","avatar_url":"https://github.com/Life-Experimentalist.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎮 Global Save State\n### *Save Points for Your Code - Just Like in Games!*\n\n\u003cdiv align=\"center\"\u003e\n\n![Global Save State Logo](icon.jpg)\n\n**Create checkpoints in your code projects just like save points in video games!**\n\n*Perfect for experiments, tutorials, learning, and quick prototypes where full version control feels like overkill*\n\n[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/VKrishna04.global-save-state)](https://marketplace.visualstudio.com/items?itemName=VKrishna04.global-save-state)\n[![Downloads](https://img.shields.io/visual-studio-marketplace/d/VKrishna04.global-save-state)](https://marketplace.visualstudio.com/items?itemName=VKrishna04.global-save-state)\n[![Rating](https://img.shields.io/visual-studio-marketplace/r/VKrishna04.global-save-state)](https://marketplace.visualstudio.com/items?itemName=VKrishna04.global-save-state)\n\n\u003c/div\u003e\n\n---\n\n## 🎯 Why Save Points for Code?\n\nRemember playing **Zelda** and hitting that checkpoint right before `Ganondorf`? Or **`Dark Souls`** where you desperately needed that bonfire before the boss? **`Global Save State`** brings that same peace of mind to coding!\n\n### 🎮 Perfect Gaming Scenarios:\n\n| 🎯 **Game Situation**           | 💻 **Code Equivalent**             |\n| ------------------------------ | --------------------------------- |\n| 🏰 **Save before boss fight**   | Save before major refactoring     |\n| 🧪 **Try different strategies** | Experiment with new approaches    |\n| 📚 **Chapter checkpoints**      | Milestone completion in tutorials |\n| 🎨 **Creative experimentation** | Art projects, creative coding     |\n| ⚡ **Speed runs**               | Rapid prototyping cycles          |\n| 🔄 **Multiple playthroughs**    | Different implementation attempts |\n\n### 🚀 When to Use Your Code Save Points:\n- **🧪 Experiments**: Try wild ideas without fear - restore if they don't work\n- **📚 Learning**: Checkpoint your progress while following tutorials\n- **🚀 Prototyping**: Quick saves for rapid iteration cycles\n- **🔧 Refactoring**: Save before major changes, restore if things break\n- **🎨 Creative Coding**: Art projects, game jams, creative experiments\n- **📝 Documentation**: Save states while writing examples or demos\n\n### 🚫 When to Use Git Instead:\n- Large production codebases\n- Team collaboration projects\n- Code that needs detailed history tracking\n- Professional development workflows\n\n## ✨ Game Mechanics for Code\n\n### 🎮 Just Like Your Favorite Games\n\n| 🎯 **Game Feature**       | 💻 **Global Save State** | 🔥 **Why It's Awesome**       |\n| ------------------------ | ----------------------- | ---------------------------- |\n| 💾 **Quick Save**         | `Ctrl+Shift+S`          | Instant checkpoint creation  |\n| 🔄 **Quick Load**         | `Ctrl+Alt+R`            | Instant project restoration  |\n| 📍 **Named Saves**        | \"Before AI Integration\" | Descriptive checkpoint names |\n| 🎯 **Save Slots**         | Up to 50 per project    | Multiple restore points      |\n| ⚡ **No Loading Screens** | Instant restore         | Zero wait time               |\n| 🎪 **Multiple Campaigns** | Multi-root workspaces   | Independent save systems     |\n\n### 🚀 Core Features\n\n- **💾 Create Named Save Points**: Capture your entire project state with custom names\n- **🔄 Instant Restore**: Quickly restore to any previous save point\n- **📁 Multi-Root Support**: Each workspace folder maintains its own save points independently\n- **⚙️ Flexible Exclusions**: Configure exclusion patterns per folder via `.vscode/settings.json`\n- **⚡ Smart Detection**: Automatically handles empty save points when no changes are detected\n- **🎯 Not a VCS**: Lightweight alternative to version control for quick state management\n\n## 📦 Installation\n\n### 🎮 From VS Code Marketplace (Recommended)\n1. Open VS Code\n2. Go to Extensions (`Ctrl+Shift+X`)\n3. Search for \"**Global Save State**\"\n4. Click **Install**\n5. Start creating save points! 🎉\n\n### 📁 From VSIX File\n1. Download the `.vsix` file from [releases](https://github.com/Life-Experimentalist/global-save-state/releases)\n2. Open VS Code\n3. Run `Extensions: Install from VSIX...` from Command Palette\n4. Select the downloaded `.vsix` file\n\n## 🎮 Quick Start Guide - Your First Save Point!\n\n### 🕹️ Tutorial Mode (5 minutes)\n\n**Step 1: Set the Scene** 🎬\n```bash\n# Open any project in VS Code\n# Make some changes to your files\n# Now you're ready for your first checkpoint!\n```\n\n**Step 2: Create Your First Save Point** 💾\n1. Press `Ctrl+Shift+S` (your \"Save Game\" button)\n2. Name it: **\"Tutorial Checkpoint 1\"**\n3. Watch the magic happen! ✨\n\n**Step 3: Make Some Changes** 🔨\n```javascript\n// Add some experimental code\nfunction experimentalFeature() {\n    // This might break everything...\n    return 'risky code here';\n}\n```\n\n**Step 4: Create Another Checkpoint** 📍\n1. Press `Ctrl+Shift+S` again\n2. Name it: **\"Added Experimental Feature\"**\n\n**Step 5: Oh No! Something Broke!** 💥\n1. Press `Ctrl+Alt+R` (your \"Load Game\" button)\n2. Select **\"Tutorial Checkpoint 1\"**\n3. **BOOM!** 🎉 You're back to safety!\n\n\u003e 💡 **Pro Gamer Tip**: Use descriptive save names like \"Before Adding Database\", \"Working Login System\", or \"Pre-Boss-Fight-Refactor\"\n\n## 🎯 Advanced Usage\n### 💾 Creating Save Points (Quick Save)\n- **🎮 Keyboard**: `Ctrl+Shift+S` (or `Cmd+Shift+S` on Mac)\n- **📝 Command Palette**: `Global Save State: Create Save Point`\n\n**Multi-Workspace Projects:**\n1. If multiple workspace folders are open, select which folder to save\n2. Enter a descriptive name for your save point (think epic checkpoint names!)\n3. The extension captures all files (excluding configured patterns)\n\n### 🔄 Loading Save Points (Quick Load)\n- **🎮 Keyboard**: `Ctrl+Alt+R` (or `Cmd+Alt+R` on Mac)\n- **📝 Command Palette**: `Global Save State: Restore Save Point`\n\n**Restore Process:**\n1. If multiple workspace folders are open, select which folder to restore\n2. Choose from your list of save points (sorted by newest first)\n3. Your project is instantly restored to that exact state\n\n\u003e ⚠️ **Boss Fight Warning**: Just like in games, loading a save point will overwrite your current progress! Save first if you want to keep changes.\n\n## ⚙️ Configuration\n\n### Per-Folder Settings\nCreate `.vscode/settings.json` in any workspace folder:\n\n```json\n{\n  \"globalSaveState.excludePatterns\": [\n    \"**/node_modules/**\",\n    \"**/.git/**\",\n    \"**/dist/**\",\n    \"**/build/**\",\n    \"**/.vscode/**\",\n    \"**/out/**\",\n    \"**/*.log\"\n  ]\n}\n```\n\n### Global Settings\n- **Max Save Points**: Configure maximum save points to keep (default: 50)\n- **Default Exclusions**: Set global exclusion patterns\n\n## 📋 Requirements\n\n- VS Code 1.74.0 or higher\n- Node.js 16.0.0 or higher\n\n## 🔧 Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/Life-Experimentalist/global-save-state\n\n# Install dependencies\nnpm install\n\n# Compile TypeScript\nnpm run compile\n\n# Run tests\nnpm test\n\n# Build extension package\nnpm run build\n```\n\n## 📖 Documentation\n\n- [Architecture](docs/ARCHITECTURE.md): System design and diagrams\n- [Roadmap](docs/ROADMAP.md): Milestones and future plans\n- [TODO](docs/TODO.md): Tasks and bugs\n- [Changelog](docs/CHANGELOG.md): Release notes\n- [License](LICENSE.md): License information\n- [Code of Conduct](docs/CODE_OF_CONDUCT.md): Community guidelines\n\n## 🤝 Contributing\n\nSee [Contributing Guide](.github/ISSUE_TEMPLATE/CONTRIBUTING.md) for details on:\n- Code style guidelines\n- How to submit pull requests\n- Bug reporting process\n\n## 📄 License\n\nLicensed under the [Apache 2.0 License](LICENSE.md).\n\n## 🐛 Issues \u0026 Support\n\n- Report bugs: [GitHub Issues](https://github.com/Life-Experimentalist/global-save-state/issues)\n- Feature requests: [GitHub Issues](https://github.com/Life-Experimentalist/global-save-state/issues)\n- Email: krishnagsvv@gmail.com\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**🎮 Happy Coding with Save Points! 🎉**\n\n*Made with ❤️ for developers who miss game checkpoints in their code*\n\n[🌟 Star on GitHub](https://github.com/Life-Experimentalist/global-save-state) | [📦 VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Life-Experimentalist.global-save-state)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flife-experimentalist%2Fglobal-save-state","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flife-experimentalist%2Fglobal-save-state","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flife-experimentalist%2Fglobal-save-state/lists"}