Shell integration warning on first run
Shell integration warning on first run
Restart VS Code and open a new terminal session.
Linux notifications (ENOENT on task completion)
Linux notifications (ENOENT on task completion)
Install the notification helper:
sudo apt install libnotify-binJ-Link not detected / board not auto-detected
J-Link not detected / board not auto-detected
Confirm the SEGGER J-Link drivers are installed and the board enumerates in
nrfjprog --ids. Re-plug the board and reload the VS Code window.Flash command fails
Flash command fails
Make sure no other tool (nRF Connect for Desktop, OpenOCD) holds the J-Link interface. Only one process can flash at a time.
ESP-IDF not detected
ESP-IDF not detected
Confirm ESP-IDF is installed and
IDF_PATH is set in the environment VS Code launched from. The Espressif IDF extension sets this up for you; after installing it, reload the VS Code window.ESP serial port not found
ESP serial port not found
Check that the board enumerates as a serial port. Most ESP dev boards need a USB-to-UART driver: CP210x or CH340 depending on the board. Install the driver, re-plug the board, and reload the window.
ESP flash fails
ESP flash fails
Confirm the correct serial port and chip target are selected, no serial monitor is holding the port, and the board is in download mode (some boards need the BOOT button held while connecting). Then retry the flash.
AI provider authentication errors
AI provider authentication errors
Verify your API key in the extension settings and that the endpoint URL matches your provider (for example
https://openrouter.ai/api/v1 for OpenRouter).Model refuses tool calls or returns plain text
Model refuses tool calls or returns plain text
The configured model must support native tool-calling. Models without function-calling cannot drive hardware workflows. See Models.