{"_id":"@bomoge/vibe-check","_rev":"2-196069e18bdf61f5606c79612d314e4a","name":"@bomoge/vibe-check","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@bomoge/vibe-check","version":"1.0.0","keywords":["git","checkpoint","workflow","cli","version-control","ai-assisted","development","simple","wrapper"],"author":{"url":"https://bomoge.pl","name":"Adrian Górak","email":"adriangorak98@gmail.com"},"license":"MIT","_id":"@bomoge/vibe-check@1.0.0","maintainers":[{"name":"bomoge","email":"adrian.gorak@bomoge.pl"}],"homepage":"https://github.com/pr0d5h381/vibe-check#readme","bugs":{"url":"https://github.com/pr0d5h381/vibe-check/issues"},"os":["darwin","linux","win32"],"bin":{"vibe-check":"bin/vibe-check"},"dist":{"shasum":"8868a8556a65378911bc237ddd04f1135c2ffd35","tarball":"https://registry.npmjs.org/@bomoge/vibe-check/-/vibe-check-1.0.0.tgz","fileCount":4,"integrity":"sha512-waHCJh6h3R7YReYPr+/BRvrpsKD15ja5T65yzT8WDWkP296tiZXYugoN1jhwGrdBvBpjdtwLLxdVR/LHUW541w==","signatures":[{"sig":"MEUCIQD9fqVmVvKJ5ua34xB+Xnld4WBkI/MDSB0gbdkZn1VmLQIgISHS/FY3u3KhLZMSeyQHHrm4oOY0AG3V1cdZ5rft32w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7234246},"main":"bin/vibe-check","engines":{"node":">=14.0.0"},"gitHead":"ad55fbf8c96134c37f8c7423d991f5fdde1b949d","scripts":{"test":"go test ./...","build":"go build -o bin/vibe-check .","prepack":"npm run build"},"_npmUser":{"name":"bomoge","email":"adrian.gorak@bomoge.pl"},"repository":{"url":"git+https://github.com/pr0d5h381/vibe-check.git","type":"git"},"_npmVersion":"11.4.2","description":"Simple Git workflow made easy - no more complex commands!","directories":{},"_nodeVersion":"23.10.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/vibe-check_1.0.0_1754226421343_0.34156927470815623","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bomoge/vibe-check","version":"1.0.1","description":"Simple Git workflow made easy - no more complex commands!","main":"bin/vibe-check","bin":{"vibe-check":"bin/vibe-check"},"scripts":{"prepack":"npm run build","build":"go build -o bin/vibe-check .","test":"go test ./..."},"keywords":["git","checkpoint","workflow","cli","version-control","ai-assisted","development","simple","wrapper"],"author":{"name":"Adrian Górak","email":"adriangorak98@gmail.com","url":"https://bomoge.pl"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/pr0d5h381/vibe-check.git"},"bugs":{"url":"https://github.com/pr0d5h381/vibe-check/issues"},"homepage":"https://github.com/pr0d5h381/vibe-check#readme","engines":{"node":">=14.0.0"},"os":["darwin","linux","win32"],"_id":"@bomoge/vibe-check@1.0.1","gitHead":"85e8a352c9e91a2a9afd0dc41f71d0345912399c","_nodeVersion":"23.10.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-4x/qgkpodKPiviEYUkc0kDSzq9Q9Tt1ya4Nnf2M8s8xo76Qej1GSwPzGpIRw/ZMHmrjj7oWWJ1GUXgc6DrNt1A==","shasum":"f261b34caef2e9532f11b35c0885a9b368f2854c","tarball":"https://registry.npmjs.org/@bomoge/vibe-check/-/vibe-check-1.0.1.tgz","fileCount":4,"unpackedSize":7234246,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCWhRVckxK/+3vxHO+KtsB/mb52OPM0zgtc+H3vl7VnDAIgXnHgbIcKi1dlNWkEq6bOGErirAY6ivU+qjpYFRteT6Q="}]},"_npmUser":{"name":"bomoge","email":"adrian.gorak@bomoge.pl"},"directories":{},"maintainers":[{"name":"bomoge","email":"adrian.gorak@bomoge.pl"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vibe-check_1.0.1_1754229263059_0.12340690317870906"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-03T13:07:01.253Z","modified":"2025-08-03T13:54:23.607Z","1.0.0":"2025-08-03T13:07:01.619Z","1.0.1":"2025-08-03T13:54:23.348Z"},"bugs":{"url":"https://github.com/pr0d5h381/vibe-check/issues"},"author":{"name":"Adrian Górak","email":"adriangorak98@gmail.com","url":"https://bomoge.pl"},"license":"MIT","homepage":"https://github.com/pr0d5h381/vibe-check#readme","keywords":["git","checkpoint","workflow","cli","version-control","ai-assisted","development","simple","wrapper"],"repository":{"type":"git","url":"git+https://github.com/pr0d5h381/vibe-check.git"},"description":"Simple Git workflow made easy - no more complex commands!","maintainers":[{"name":"bomoge","email":"adrian.gorak@bomoge.pl"}],"readme":"# Vibe Check\n\n> Simple Git workflow made easy - no more complex commands!\n\n**Vibe Check** is a lightweight CLI tool that simplifies Git version management. Tired of complicated Git commands with endless options? This tool gives you a clean, intuitive interface for creating checkpoints, switching between versions, and cleaning up your commit history.\n\n**Why Vibe Check?**\n- Git commands are complex and overwhelming with too many options\n- Easy to make mistakes with `git reset`, `git rebase`, `git cherry-pick`\n- Perfect for iterative development, experimentation, and AI-assisted coding\n- Simplifies the entire Git workflow into simple menu choices\n\n## ✨ Features\n\n### 🎯 **Simple Checkpoint System**\nInstead of complex Git commands, just use simple menu options:\n- **Create Checkpoint** - Save your current work instantly (like `git add . && git commit`)\n- **Change Checkpoint** - Switch between any version (replaces complex `git checkout`/`git reset`)\n- **Finalize and Push** - Clean up and push to remote (handles `git rebase`, `git push --force-with-lease`)\n\n### 🚀 **No More Command Hell**\nForget about:\n- `git rebase -i HEAD~5` - Complex interactive rebasing\n- `git reset --hard HEAD~3` - Dangerous hard resets  \n- `git cherry-pick abc123` - Confusing commit picking\n- `git push --force-with-lease` - Scary force pushing\n\n## 🔒 Safety & Privacy\n\n### 🛡️ **How It Works**\n- **Simple wrapper** - Vibe Check only executes `git` commands in your terminal\n- **No network access** - Just runs `git add`, `git commit`, `git checkout`, `git push`, etc.\n- **Transparent operations** - Everything it does, you could do manually with Git commands\n\n**Vibe Check handles it all with simple menu navigation!**\n\n## 🛠️ Installation\n\n### NPM (Recommended)\n```bash\n# Install globally\nnpm install -g @bomoge/vibe-check\n\n# Use immediately\nvibe-check\n```\n\n### From Binary\n```bash\n# Install globally (macOS with Homebrew)\ncp vibe-check /opt/homebrew/bin/vibe-check\n\n# Or to /usr/local/bin (requires sudo)\nsudo cp vibe-check /usr/local/bin/vibe-check\n```\n\n### From Source\n```bash\ngit clone https://github.com/pr0d5h381/vibe-check.git\ncd vibe-check\ngo build -o vibe-check .\n```\n\n## 🚦 Usage\n\n### Interactive Mode (TUI)\nNavigate to any Git repository and run:\n\n```bash\nvibe-check\n```\n\nUse arrow keys to navigate the menu, Enter to select, and follow the intuitive interface.\n\n### Command Line Mode\nFor quick operations and scripting:\n\n```bash\n# Create checkpoint with custom note\nvibe-check create \"Testing new feature\"\n\n# Create checkpoint with auto-generated timestamp\nvibe-check create\n\n# List all checkpoints  \nvibe-check list\n\n# Switch to specific checkpoint\nvibe-check switch abc1234\n\n# Finalize and push with custom message\nvibe-check finalize \"Implement user authentication\"\n\n# Finalize and push with auto-generated timestamp message\nvibe-check finalize\n```\n\n### Available Commands\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `vibe-check` | Launch interactive TUI | `vibe-check` |\n| `vibe-check create [note]` | Create checkpoint with optional note | `vibe-check create \"WIP: auth system\"` |\n| `vibe-check list` | Show all checkpoints with current marked | `vibe-check list` |\n| `vibe-check switch <hash>` | Switch to specific checkpoint | `vibe-check switch abc1234` |\n| `vibe-check finalize [message]` | Squash and push with optional message | `vibe-check finalize \"Add login feature\"` |\n| `vibe-check --help` | Show all available commands | `vibe-check --help` |\n\n### Auto-Generated Messages\n\nWhen you don't provide custom notes or messages, vibe-check automatically generates them:\n\n**Create checkpoint without note:**\n```bash\nvibe-check create\n# Creates: \"CHECKPOINT: 03/08/2025 14:30\"\n```\n\n**Create checkpoint with note:**\n```bash\nvibe-check create \"Testing auth\"\n# Creates: \"CHECKPOINT: 03/08/2025 14:30 - Testing auth\"\n```\n\n**Finalize without message:**\n```bash\nvibe-check finalize  \n# Creates: \"Update: 03/08/2025 14:30\"\n```\n\n**Finalize with custom message:**\n```bash\nvibe-check finalize \"Add user authentication\"\n# Creates: \"Add user authentication\"\n```\n\n### Simple Workflow (No Git Knowledge Required!)\n\n1. **Make some changes** - Edit your code\n2. **Create checkpoint** - Save a snapshot (arrow keys → Enter)\n3. **Try different approach** - Make more changes, create another checkpoint\n4. **Switch between versions** - Use \"Change Checkpoint\" to compare approaches\n5. **Found the right solution?** - Use \"Finalize and Push\" to clean up and ship it\n\n**That's it!** No complex Git commands, no fear of losing work, no messy commit history.\n\n## 🆚 Before vs After\n\n### Before (Traditional Git):\n```bash\n# Save work\ngit add .\ngit commit -m \"WIP: trying approach 1\"\n\n# Try different approach  \ngit reset --hard HEAD~1\n# Make changes\ngit add .\ngit commit -m \"WIP: trying approach 2\"\n\n# Go back to first approach\ngit log --oneline  # find the commit hash\ngit checkout abc123\n\n# Clean up commits\ngit rebase -i HEAD~5  # complex interactive editor\ngit push --force-with-lease origin main  # scary!\n```\n\n### After (vibe-check):\n```bash\nvibe-check\n# → Arrow keys to navigate menu\n# → Create Checkpoint (saves approach 1)\n# → Create Checkpoint (saves approach 2) \n# → Change Checkpoint (switch between versions)\n# → Finalize and Push (clean commit + push)\n```\n\n## 🎨 Screenshots\n\n<img width=\"369\" height=\"248\" alt=\"image\" src=\"https://github.com/user-attachments/assets/b043d6c7-15f8-43e9-990e-ff3ad2624ab0\" />\n\n<img width=\"375\" height=\"194\" alt=\"image\" src=\"https://github.com/user-attachments/assets/d5db9976-91ee-466a-b60c-321e7a964545\" />\n\n<img width=\"625\" height=\"180\" alt=\"image\" src=\"https://github.com/user-attachments/assets/a25c2bba-1b5c-4926-974b-8b5dd3dff1db\" />\n\n<img width=\"513\" height=\"179\" alt=\"image\" src=\"https://github.com/user-attachments/assets/6715a90a-1517-4aba-a31a-156a482bdd84\" />\n\n<img width=\"376\" height=\"195\" alt=\"image\" src=\"https://github.com/user-attachments/assets/8b0d31bb-ba14-4918-a777-48129f145728\" />\n\n## 🛡️ Requirements\n\n- Git repository (initialized)\n- Go 1.21+ (for building from source)\n- Terminal with color support\n\n## 📖 Philosophy\n\n**Git is powerful but intimidating.** Most developers spend more time fighting Git commands than actually coding. vibe-check fixes this by:\n\n- **Hiding complexity** - You don't need to know `git rebase` or `git cherry-pick`\n- **Preventing mistakes** - No more accidental `git reset --hard` disasters\n- **Encouraging experimentation** - Try ideas fearlessly with easy checkpoints\n- **Cleaning up automatically** - Messy development becomes clean commit history\n\nPerfect for:\n- 🤖 **AI-assisted coding** - Create checkpoints between AI suggestions\n- 🧪 **Experimental development** - Try multiple approaches safely\n- 🔄 **Refactoring** - Save checkpoints before big changes\n- 📚 **Learning** - Experiment with new code without fear\n- 👥 **Team projects** - Clean commit history for better collaboration\n\n## 🤖 AI Assistant Instructions\n\nCopy and paste this prompt into your AI coding session to teach your AI assistant about vibe-check:\n\n<details>\n<summary>📋 Click to expand AI Prompt (Copy-paste ready)</summary>\n\n```text\nVIBE-CHECK WORKFLOW INSTRUCTIONS:\n\nYou are working with a user who has vibe-check installed for Git checkpoint management. Follow these rules:\n\nCHECKPOINT CREATION:\n- After ANY code change that the user confirms works correctly, immediately create a checkpoint\n- Use: vibe-check create \"description of what was implemented/fixed\"\n- Be descriptive but concise in checkpoint descriptions\n- Examples: \"Add user authentication\", \"Fix database connection bug\", \"Implement email validation\"\n\nCHECKPOINT SWITCHING:\n- BEFORE suggesting to switch to a previous checkpoint, ALWAYS ask: \"Should I create a checkpoint of current progress first to avoid losing work?\"\n- Only suggest switching when comparing approaches or reverting to earlier working state\n- Use: vibe-check switch <hash>\n- Always explain WHY we're switching: \"Let's switch back to checkpoint abc123 to compare the two authentication approaches\"\n\nFINALIZE AND PUSH:\n- ONLY suggest vibe-check finalize when user explicitly wants to clean up and push to remote\n- Always ask for confirmation: \"Ready to finalize all checkpoints into a clean commit and push to remote?\"\n- Use custom message: vibe-check finalize \"Meaningful commit message\"\n\nSAFETY RULES:\n- NEVER switch checkpoints without creating a checkpoint first (risk of losing work)\n- NEVER finalize without user's explicit permission\n- Always suggest vibe-check list to show available checkpoints before switching\n- If user seems lost, suggest vibe-check to open the interactive menu\n\nWORKFLOW EXAMPLE:\n1. User: \"The login form works now\"\n   You: vibe-check create \"Implement login form with validation\"\n\n2. User: \"Let's try a different approach\"\n   You: \"Should I create a checkpoint first? Then we can switch back if needed.\"\n   User: \"Yes\"\n   You: vibe-check create \"Working login form - before trying alternative\"\n\n3. User: \"I want to go back to the previous version\"\n   You: vibe-check list (show options), then vibe-check switch abc123\n\n4. User: \"This looks good, let's ship it\"\n   You: \"Ready to finalize all checkpoints and push to remote?\"\n   User: \"Yes\"\n   You: vibe-check finalize \"Add complete login system with validation\"\n```\n\n</details>\n\n## 🤝 Contributing\n\n**Vibe Check** is open source! We welcome contributions, bug reports, and feature requests.\n\n- 🐛 **Found a bug?** [Open an issue](https://github.com/pr0d5h381/vibe-check/issues)\n- 💡 **Have an idea?** [Start a discussion](https://github.com/pr0d5h381/vibe-check/discussions)\n- 🛠️ **Want to contribute?** Fork the repo and submit a pull request!\n\n### Development Setup\n\n```bash\ngit clone https://github.com/pr0d5h381/vibe-check.git\ncd vibe-check\ngo mod tidy\ngo build -o vibe-check .\n```\n\n## 📄 License\n\nMIT License - feel free to use, modify, and distribute!\n\n## 👨‍💻 Author\n\nCreated by **Adrian Górak** - [bomoge.pl](https://bomoge.pl)\n","readmeFilename":"README.md"}