BreakPoint 🔍

See exactly what changed since your project last worked.

BreakPoint is a privacy-first Visual Studio Code extension designed to answer the most frustrating question in software development:

"My code was working 10 minutes ago. What exact files did I touch before it broke?"

🌟 Features

• 🎯 Instant Baseline Checkpoints: Save a snapshot of your entire workspace the moment your code is working cleanly.
• 🚀 Test & Build Integration: Run your project's build or test commands directly through BreakPoint. It automatically creates a checkpoint if the build succeeds (exit code 0)!
• 🔍 Real-Time Difference Tracking: When your code breaks, BreakPoint scans your files to show exactly what was modified, added, or deleted since your last working checkpoint.
• ⚖️ One-Click Diff Viewer: Click any modified file in the BreakPoint sidebar to instantly open a side-by-side Diff View comparing your current broken code against the working baseline.
• 🔒 100% Privacy Focused: Operates entirely locally. BreakPoint does not use the cloud, external APIs, or AI. Your source code never leaves your machine.

🛠️ How to Setup & Configure

1. Install the Extension from the VS Code Marketplace.
2. Open the Settings: Go to VS Code Settings (Ctrl+,) and search for BreakPoint.
3. Configure your Build Command: In the setting breakpoint.runCommand, enter the command you use to run or test your project (e.g., npm run build, npm start, python main.py, npm test). The default is npm run build.

📖 Crystal Clear Usage Guide

There are two main ways to use BreakPoint: Automated and Manual.

Method 1: The Automated Way (Recommended)

You can let BreakPoint automatically handle checkpoints for you whenever your code compiles or passes tests successfully.

1. Open the Command Palette (Ctrl+Shift+P).
2. Run the command: BreakPoint: Run Project.
3. BreakPoint will execute the command you configured in your settings.
4. If it succeeds: BreakPoint automatically saves your files as a "Working Checkpoint".
5. If it fails later: Open the BreakPoint Sidebar (the icon on your far left Activity Bar). It will show you a clean tree view of every single file you modified since the last time it succeeded.

Method 2: The Manual Way

Sometimes you just want to mark a manual save point without running a build command.

1. When your code is working exactly how you want it, press Ctrl+Shift+P.
2. Run the command: BreakPoint: Mark Current State as Working.
3. Go break your code! Make changes across multiple files.
4. Click the Refresh Change button on the BreakPoint Sidebar (or the ✓ BreakPoint icon in your bottom status bar).
5. The sidebar will populate with every modified, added, or deleted file.
6. Click any Modified File to immediately see a split-window Diff comparing the difference!

🗺️ Example of the Sidebar View

When changes are detected, your sidebar will look something like this:

Last working: 10:32 AM

Modified 📝
├── src/controllers/userController.ts
└── src/app.js

Added ➕
└── src/utils/auth.ts

Deleted ❌
└── None

⚙️ Commands Included

You can execute any of these by pressing Ctrl+Shift+P:

• BreakPoint: Run Project - Executes your build command and tracks success/failure.
• BreakPoint: Mark Current State as Working - Manually forces a baseline checkpoint.
• BreakPoint: Refresh Changes - Recalculates the file changes and updates the sidebar.
• BreakPoint: Clear Checkpoint - Wipes your saved checkpoint data.

🔒 Privacy & Storage

BreakPoint calculates secure SHA-256 hashes of your project files. It does not upload or analyze your source code remotely. Everything stays completely offline on your computer. Checkpoints are stored efficiently within your VS Code local workspace storage.