The Ultimate Debugging Companion for GNOME Shell Extension Developers
Developed by Narkagni
Dev Sentry is a specialized GNOME Shell extension designed to streamline the workflow of extension developers. It eliminates the need to constantly switch between terminals and the GUI by bringing logs, debugging tools, and shell management directly into the top panel.
The Main Panel: Real-time log streaming with color-coded errors.
Nested Shell & Preferences: Launch a nested instance for safe testing and filter logs by project path.
Real-Time Log Streaming
Dev Sentry streams logs directly from journalctl. It explicitly filters out system noise and categorizes entries:
- JS ERROR: Standard JavaScript errors in your code.
- CRITICAL: Gjs and GNOME Shell critical warnings.
- TRACE: Stack traces and custom log messages.
One-Click "Fix" (VS Code Integration)
When an error occurs, Dev Sentry parses the stack trace to find the file path and line number. Clicking the error row in the panel immediately opens VS Code at the exact line where the crash happened.
Nested Shell Launcher
Test your changes safely without logging out. The panel includes a dedicated button to launch a Nested GNOME Shell instance within a window (Wayland supported). This allows for rapid iteration cycles and prevents freezing your main user session.
Smart Project Filtering
Working on multiple extensions simultaneously? In the preferences, you can set your active Project Folder. Dev Sentry will monitor the UUID of that folder and filter the stream to show only logs and errors originating from that specific extension.
- GNOME Shell 45 - 49
libglib2.0-bin(Required for schema compilation)- VS Code (Recommended for the Click-to-Fix feature)
1. Clone the repository
git clone https://github.com/NarkAgni/dev-sentry.git cd dev-sentry
2. Install using Make
make install
3. Restart GNOME Shell
For X11: Press Alt+F2, type r, and hit Enter.
For Wayland: Log out and log back in.
4. Enable the extension
gnome-extensions enable dev-sentry@narkagni
Dev Sentry is open-source and free. If this tool helps you debug faster and saves you time, consider supporting the development.
Crypto Addresses
Bitcoin (BTC):
1GSHkxfhYjk1Qe4AQSHg3aRN2jg2GQWAcV
Ethereum (ETH):
0xf43c3f83e53495ea06676c0d9d4fc87ce627ffa3
Tether (USDT - TRC20):
THnqG9nchLgaf1LzGK3CqdmNpRxw59hs82
License: GPL-3.0