Run current File: runs the currently open .py file directly on the board
Run Selection: runs the selected code snippet
Input and Output via Terminal
Control the Board
Stop Board: interrupts a running script (sends Ctrl+C)
Soft Reset: restarts the MicroPython runtime without physically disconnecting the board (sends Ctrl+D)
Open REPL Console: opens an interactive Python terminal connected to the board
Concurrent Boards
Extension allow multiple connections
Connections handled via tabs. + connect, x disconnect
Switch tab to access other board
Board File System
Browse files and folders on the board
Open a board file (doubleclick) in Editor, edit it locally, and upload it back with the upload button or save command
Rename, delete, and create files directly on the board
Drag and drop move
Workspace
Shows workspace with most important actions
Drag and drop move
Mount Workspace
Mount Workspace connects your local VS Code workspace folder directly to the board's filesystem using mpremote mount.
While mounted, files you save locally are immediately visible and executable on the board, no manual upload step needed.
How to use:
Click Mount Workspace in the sidebar.
If there are subfolders, choose the folder to mount in the Quick Pick Menu.
A terminal opens and the board connects in REPL mode.
Run files or interact with the REPL directly in the mount terminal.
When done, click Unmount (the same button) or Ctrl-X in the terminal to cleanly disconnect.
Manage Libraries
Search and install packages from the Arduino package index
View and uninstall installed libraries
Install custom packages via GitHub URL (e.g. github:user/repo@v1.0.0)
Code Support (Autocomplete)
Set up board-specific MicroPython module stubs (machine, network, etc.) for Pylance/Pyright
Generate type hints and autocomplete for installed libraries
Overview over library code support in current workspace
Regenerate Code Support in your workspace for current board
AI Support
GitHub Copilot and Claude Code are supported.
Can be activated in extension settings.
.github/copilot-instructions.md is automatically generated with instructions on how to find dependencies that are in the current workspace.
For other AIs just copy the generated instructions into their instruction file.
Troubleshooting
mpremote not found / installation fails.
Run pip install mpremote manually in your terminal, then reload VS Code.
Python not found.
Make sure Python is installed and added to your system PATH. You can verify with python --version in a terminal.
Win 32 ARM64 does not work.
Install the x64 version of Visual Studio Code to use this extension.
Board Operation Cancelled or Access Denied.
These errors show up if the board / port is currently used by something else. If they show up but board isn't in use, press the reset button on the board or replug it.
Extension Settings
Setting
Default
Description
Auto Install Board Code Support
true
Automatically installs board-specific code support (autocomplete and type hints) when a board port is selected
