JumperIDE for VS Code

MicroPython IDE for the Jumperless V5.

Docs · Web IDE · Shop

The Jumperless V5 is a breadboard with software-defined connections — routing, ±8 V power supplies, DACs, ADCs, GPIO, all scriptable from onboard MicroPython. This extension is the VS Code counterpart to the web JumperIDE:

• F5 runs the current file on the board; Shift+F5 stops it.
• The board's filesystem shows up in the sidebar — open, edit, save back.
• The Jumperless API (connect(), dac_set(), oled_print(), TOP_RAIL, …) autocompletes and type-checks with no imports, matching how scripts run on the device.

A quick tour

▶ Watch the demo video

Connect — the board's serial ports are auto-detected by USB ID, with the MicroPython REPL port pre-selected:

REPL + device menu side by side — the MicroPython REPL and the board's interactive menu, each on its own port:

Serial terminal — pick any port (port1 is the device menu), or hand the port to the standalone Jumperless App:

OLED bitmap editor — draw pixels and watch them appear on the board's OLED live:

API reference panel — the full MicroPython API docs beside your code:

Install

• Cursor / VSCodium — search JumperIDE in the Extensions view (Open VSX).
• VS Code — search JumperIDE, or download the .vsix from the latest release (install command included in the release notes).

Plug in the board and click the connection button at the top of the Jumperless sidebar (or run Jumperless: Connect from the command palette, or click the plug icon in the status bar). No drivers needed.

Features

Serial connection — the V5 exposes four USB serial ports; the extension detects them by USB ID and pre-selects the MicroPython REPL port (the 3rd). Set jumperless.connectOnStartup to connect automatically.

Actions panel — everything in one sidebar panel: a connection button that doubles as live status (hover to connect or disconnect), Run/Stop, Save to Jumperless, Save Locally (export a device file to your computer), New OLED Bitmap, the Serial Terminal, and quick access to the API reference and JumperNet publishing.

Run / Stop — F5 executes the current editor buffer on the board, output streams to the REPL terminal. Shift+F5 interrupts.

Device file browser — the board's filesystem in the sidebar. Files open as local working copies (so the language server works on them); saving pushes back to the board. Files that didn't come from the board ask for a device path on first save, then remember it. Create, delete, and upload files and folders.

REPL terminal — a terminal connected to the board's MicroPython prompt. Handles MicroPython line endings and batches output so fast prints don't stall the UI.

Serial terminal — pick any serial port (port1, the board's menu/CLI, is recommended) for a direct raw-passthrough terminal — the full-color menus and ANSI art render exactly as the board sends them. Or pick Use Jumperless App to run the standalone Jumperless App instead (auto-installs from PyPI; autodetects the port and handles reconnection).

Autocomplete & hover docs — signatures and descriptions for every Jumperless function, sourced from the API reference and refreshed automatically. Jumperless calls and constants are highlighted in Python files.

OLED bitmap editor — a pixel editor for OLED .bin files. While connected, edits push live to the board's OLED as you draw. Jumperless: New OLED Bitmap creates a blank 128×32 canvas on the device or locally.

JumperNet registry — browse community scripts and OLED images, open them, save them to the board, or publish your own (Jumperless: Publish Script to Registry).

API reference panel — Jumperless: Open API Reference opens the MicroPython API docs beside your code.

Zero-import autocomplete

On the board, scripts run with the full API preloaded (from jumperless import * happens before your code). The editor matches that automatically: on first activation the extension installs typed stubs and points your Python analyzer at them, so files opened from the device resolve the whole API with no imports and no setup. (Controlled by jumperless.setup.autoSetUpGlobally, on by default.)

• typings/jumperless.pyi — typed stub, synced from JumperlOS
• typings/builtins.pyi — standard-library builtins with Jumperless globals layered on top (typo detection still works)
• typings/time.pyi — MicroPython time extras (ticks_ms, sleep_ms, …)

To get the same thing in one of your own project folders (checked into that repo instead of user settings), run Jumperless: Set Up This Folder for Jumperless Python — it writes the typings/ folder and a pyrightconfig.json into the workspace.

Each piece is a toggle under Settings → Jumperless:

Set globalRecognition and writeProjectConfig to false to keep only the module stub and use from jumperless import * explicitly.

Commands

Settings

Plus the jumperless.setup.* toggles above.

Requirements

• VS Code 1.84+ (or recent Cursor / VSCodium)
• A Jumperless V5 connected via USB
• Optional: Python + Pylance for full autocomplete and type checking

Troubleshooting

• No ports listed — check that the USB cable carries data and the board is powered.
• Connected but nothing works — probably the wrong port; the REPL is the 3rd (marked "recommended" in the picker).
• "Resource busy" opening a port — something else has it open, usually the standalone Jumperless App. Quit it (Ctrl+Q) and retry.
• Ctrl+Q in device menus — works as expected in Jumperless terminals; the extension passes it through to the board instead of letting the editor shortcut fire.
• Staircased terminal output — make sure jumperless.terminal.convertEol is on.
• Keystrokes not reaching the board — enable jumperless.terminal.debugIo and check the "JumperIDE Terminal IO" output channel.
• Anything else — run Jumperless: Show Activation Log and open an issue.

For maintainers

Acknowledgments

Based on the web JumperIDE and ViperIDE. Autocomplete stubs are synced from JumperlOS.

License

The Unlicense — public domain.