Runtime Error Break
A professional VS Code extension that detects runtime errors from terminal processes and optionally opens a user-defined URL for a short break.
Features
- Automatic Runtime Detection - Detects development server processes (Laravel, React, Node.js, Python, Rails, Go, etc.)
- Security First - Always requests user confirmation before opening any URL
- Fully Configurable - URL, delay, and enable/disable settings under user control
- Status Bar Indicator - Visual indicator for monitoring status
- Anti-Spam Protection - Prevents repeated browser openings
Installation
Via VS Code Marketplace
- Open VS Code
- Press
Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (Mac)
- Search for "Runtime Error Break"
- Click Install
Via Command Line
code --install-extension RickyDev.runtime-error-break
Manual Installation
Download the .vsix file and install:
code --install-extension runtime-error-break-1.0.0.vsix
Configuration
This extension is disabled by default for user safety. To enable it:
- Open Settings (
Ctrl+,)
- Search for "Runtime Error Break"
- Check "Runtime Error Break: Enable"
Or add to settings.json:
{
"runtimeErrorBreak.enable": true,
"runtimeErrorBreak.url": "https://youtube.com",
"runtimeErrorBreak.delay": 2000
}
Configuration Options
| Setting |
Type |
Default |
Description |
runtimeErrorBreak.enable |
boolean |
false |
Enable or disable the extension |
runtimeErrorBreak.url |
string |
https://facebook.com |
URL to open when an error is detected |
runtimeErrorBreak.delay |
number |
1000 |
Delay in milliseconds before opening URL |
Usage
- Enable the extension in settings
- Run your development server:
php artisan serve
npm run dev
node app.js
- The extension will automatically detect the runtime process
- Status bar will display "Runtime Active"
- When an error occurs, a confirmation dialog will appear
- Select "Open Break" to open the configured URL
Commands
Access via Command Palette (Ctrl+Shift+P):
- Runtime Error Break: Test Error Detection - Test error detection functionality
- Runtime Error Break: Reset Monitoring State - Reset monitoring status
Security & Ethics
- Disabled by default
- Always requests user confirmation before taking action
- No data collection or external communication
- Open source - code is auditable
- Anti-spam protection (minimum 5-second cooldown)
- Full user control through settings
Supported Runtimes
- PHP Artisan Serve
- NPM/Yarn Dev
- Node.js Applications
- Python Django
- Rails Server
- Go Run
- Composer Scripts
Status Bar Indicators
| Icon |
Status |
Description |
$(circle-slash) |
Ready |
Waiting for runtime process |
$(play) |
Runtime Active |
Runtime process detected |
$(eye) |
Monitoring |
Monitoring for errors |
Troubleshooting
Extension does not detect runtime process
- Verify
runtimeErrorBreak.enable is set to true
- Check if the runtime command matches detection patterns
- Restart VS Code
Browser does not open
- Check internet connection
- Verify the URL is valid
- Ensure no firewall is blocking external URLs
Contributing
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
License
MIT License - See LICENSE file for details.
Author
Ricky Steven Silaban
Repository
https://github.com/rickysilaban/runtime-error-break
Support
- Email: rickysilaban384@gmail.com
- GitHub Issues: Create Issue
