¶Debugging

e has a built-in step debugger: breakpoints, a live call stack, variable inspection and step controls. It speaks the Debug Adapter Protocol (DAP), so the same UI drives every DAP-capable language:

The adapter is chosen automatically from the active file's language.

¶Quick start

1. Open a file and set a breakpoint — press F9 on a line, or ⌥-click it. A red dot appears in the editor margin.
2. Press F5 to start. The Debug panel opens and shows the session status.
3. When execution hits a breakpoint, the line is highlighted, the editor jumps to it, and the call stack + variables fill in.
4. Step through with F10 / F11 / ⇧F11, or F5 to continue.

¶Controls

The Debug panel (also reachable via Debug: Toggle Panel in the command palette, ⌘⇧P) shows execution controls, the call stack (click a frame to jump to its source), the current frame's variables, and all breakpoints. Debug: Stop ends the session.

¶PHP / Xdebug with Grove

PHP step-debugging needs two things: Xdebug loaded into the PHP that runs your app, and the vscode-php-debug adapter to translate DAP into Xdebug's DBGp protocol.

Grove supplies both:

1. Enable Xdebug in your local runtime. Either flip Enable Xdebug in Settings (⌘, → Laravel), which runs grove debug on for you, or from a terminal:

   grove debug on
   

   Grove loads Xdebug into its FPM pools in trigger mode (near-zero overhead until a request opts in). If your bundled PHP has no Xdebug, install a debug-enabled build with grove debug install <version>.

   The Settings toggle reflects Grove's real state (it's synced from grove debug status on startup) and degrades gracefully: if Grove isn't installed it just reports so in the Debug panel — the editor and its other adapters are unaffected. Debugging is entirely opt-in; e runs normally without Grove or any adapter installed.

2. In e, set breakpoints and press F5. The adapter is launched over Grove's bundled Node automatically, and Xdebug connects to it on port 9003.

3. Trigger a request that hits your breakpoint — use a browser Xdebug-helper extension, add ?XDEBUG_TRIGGER=1, or for CLI (artisan, tests) run:

   eval "$(grove debug env)"
   php artisan ...
   

¶Adapter discovery

e finds adapters from installed VS Code / Cursor extensions automatically. To point at a specific install, set an environment variable:

Node itself is discovered from Grove's runtimes, falling back to node on your PATH.

¶Troubleshooting

• "No php-debug adapter found" — install the PHP Debug extension in VS Code/Cursor, or set E_PHP_DEBUG_ADAPTER.
• Breakpoints never hit (PHP) — check grove debug on is active and that the request actually carries an Xdebug trigger (cookie/param or grove debug env).
• Rust: "Set E_DEBUG_PROGRAM" — build first (cargo build); e looks for target/debug/<crate>, or set E_DEBUG_PROGRAM to the executable.