replx

A cross-platform command-line toolkit for MicroPython development. replx runs a shared local agent so multiple terminals can work with multiple boards while reusing connections and session state.

Features

• Works on Windows, Linux, and macOS.
• Connect to multiple boards from multiple terminals, with per-session foreground and background devices.
• Discover boards, configure a workspace default, and set up VS Code MicroPython support.
• Run scripts and snippets, use the interactive REPL, and sync files and directories.
• Search and install packages with mip or pkg; compile .py files to .mpy.
• Work with GPIO, PWM, ADC, UART, SPI, I2C, I2S, BLE, and WS2812 devices (availability depends on board and firmware).
• Use MicroPython raw-paste for code submissions of 4 KiB or larger when supported; batched file uploads keep the standard raw path for throughput.

Install

python -m pip install replx

This installs both replx and the rx command.

Quick start

replx scan
replx COM4 setup
replx status
replx -c "print('Hello from MicroPython')"
replx run main.py
replx repl

Replace COM4 with the board's serial port, such as /dev/ttyUSB0 on Linux or /dev/cu.usbmodem14101 on macOS. After setup, the configured board can usually be targeted without repeating the port; specify a port when working with another board.

Documentation

This PyPI page is a short overview and quick start. See the full command reference and user manual on GitHub for connection/session behavior, commands, options, examples, and troubleshooting.

• GitHub repository
• Report an issue
• Website