General
What is Pointbreak?
Pointbreak enables AI assistants to control your VS Code debugger through natural language. Instead of adding print statements, AI can set breakpoints, step through code, and inspect variables.Is Pointbreak free?
Yes! Pointbreak is free to use. The binaries and VS Code extension are freely available, though the source code is proprietary.Does Pointbreak work offline?
Yes! All debugging happens locally on your machine. No internet connection required after installation.What languages does it support?
Pointbreak works with any language your IDE can debug:- Python (via debugpy)
- JavaScript, TypeScript (via Node Debug)
- Rust, C, C++ (via CodeLLDB)
- Go (via Delve)
- Any language with a Debug Adapter Protocol implementation
Technical
How does it work?
Pointbreak bridges AI assistants to your IDE’s native debugger using the Model Context Protocol (MCP). It doesn’t implement a new debugger—it uses your existing debug adapters. See Architecture for details.Is my code sent anywhere?
No. All debugging happens locally. Pointbreak does not:- Send code to external servers
- Collect telemetry
- Phone home
- Track usage
Does it modify my code?
No. Pointbreak only:- Sets breakpoints
- Inspects variable values
- Controls execution flow
Can I use it without an AI assistant?
Technically yes, but it’s designed for AI interaction. For manual debugging, use your IDE’s built-in debugger. Support for direct debugger control without an IDE is currently experimental and not available in the public release.Installation & Setup
Which AI assistants work with Pointbreak?
Any MCP-compatible AI assistant:- GitHub Copilot (VS Code built-in) ✅
- Cursor (built-in agent) ✅
- Claude Code ✅
- Codex ✅
- Custom MCP clients ✅
Do I need to configure anything?
GitHub Copilot / Cursor (built-in agents): No configuration needed—MCP server auto-registers when you install the extension in Visual Studio Code and Cursor. Claude Code, Codex, Windsurf, and other external AI assistants: Need to install the MCP server separately and configure your AI assistant. See AI Assistants Guide.What if my language isn’t listed?
If your language has a Debug Adapter Protocol (DAP) debugger for VS Code, Pointbreak will work with it.Usage
Why doesn’t the AI use breakpoints?
The AI might not realize debugging tools are available. Try being explicit:Can I set breakpoints manually and have AI use them?
Yes! Manual breakpoints and AI-set breakpoints work together.Do breakpoints persist between sessions?
Breakpoints set by the AI are persisted per your IDE’s capabilities. VS Code-based IDEs do not show data breakpoints (watchpoints) or instruction breakpoints, though they will be active. It’s a limitation of the VS Code debug API. Manual breakpoints in your IDE persist as usual.Can multiple people debug the same code?
Each person has their own local debug session. Shared debugging is not currently supported but is planned.Troubleshooting
The AI can’t find Pointbreak
Solutions:- Check extension is installed and enabled
- Restart your editor
- Check Output panel for errors
Breakpoints aren’t working
Common causes:- Debug adapter not installed for your language
- No debug configuration (
.vscode/launch.json) - File path issues
Debugging is slow
Try:- Reduce watch expressions
- Use conditional breakpoints
- Restart VS Code
- Check debug adapter logs
Privacy & Security
What data does Pointbreak collect?
None. Pointbreak does not collect any telemetry, analytics, or usage data.Is it safe to use at work?
Yes. Pointbreak:- Runs entirely locally
- Doesn’t send data externally
- Doesn’t modify your code
- Respects your IDE’s security model
Can I use it on proprietary code?
Yes. Your code never leaves your machine.How do I report security issues?
Email: [email protected] Do not file public issues for security vulnerabilities. See SECURITY.md.Licensing & Source Code
Is Pointbreak open source?
Pointbreak is free to use, but the source code is not licensed as Open Source Software at this time.Can I contribute code?
Code contributions are not accepted, but we welcome:- Bug reports
- Feature requests
- Documentation improvements
- Community discussions
Why isn’t it Open Source?
At this early stage, the focus is on building a solid product and gathering feedback. Open sourcing is a possibility for the future based on community demand and project maturity. Doing a good job nurturing an Open Source community is something we take seriously and will only do so if and when we have the bandwidth to do it well.Can I see the source code?
No. The source code is not publicly available at this time.Platform Support
What operating systems are supported?
- macOS 10.15+ (x64 and ARM64)
- Windows 10+ (x64 and ARM64)
- Linux (recent distributions, x64 and ARM64)
What about VS Code alternatives?
Pointbreak works with VS Code-compatible editors that support extensions:- Cursor ✅
- Windsurf ✅
- VS Codium ✅
- Others with extension support ✅
Does it work in remote development?
Yes, if your IDE supports remote debugging (e.g., VS Code Remote-SSH).Future Plans
Will there be a paid version?
Yes, paid features are being explored. Pointbreak is fully free to use. We are exploring near-term monetization by offering an Early Access Program for those willing to support the product financially. This would provide access to new features and priority support. The core functionality will remain free.What features are coming next?
We’re considering:- Replay debugging
- Team collaboration features
- Smart breakpoint suggestions
- Debug analytics
Will it become open source?
Maybe! We’ll open source if there’s strong community demand and we have the bandwidth to serve the community.Getting Help
Where do I ask questions?
- General questions: GitHub Discussions
- Bug reports: GitHub Issues
- Security issues: [email protected]
How do I report a bug?
File an issue: GitHub Issues Include:- Steps to reproduce
- Expected vs actual behavior
- Logs from Output panel
- Screenshots if applicable
How do I request a feature?
File a feature request: GitHub Issues Describe:- The problem you’re solving
- How you envision the feature
- Use cases and examples