Skip to main content

replx

PyPI version Python 3.10+ License: MIT

replx is a CLI tool for MicroPython development. A threaded TCP agent manages serial connections and coordinates multiple terminal sessions and boards.

It runs on Windows, macOS, and Linux and targets standard MicroPython 1.29 or newer, with a separate source-based legacy compatibility path for Digi XBee3 Zigbee. Hardware commands are platform-dependent; see the detailed manual's board compatibility table. Actual board testing has been completed on Raspberry Pi Pico 2 W and Waveshare ESP32-P4-WIFI6; Digi XBee3 compatibility still requires physical board validation.

What replx provides

  • Shared connection management across terminal sessions
  • Local agent with workspace-scoped endpoint settings
  • Multiple client sessions, identified by client IP and terminal SID
  • Foreground and background board handling per session
  • Workspace-level default device configuration
  • File operations on device storage
  • Script execution, REPL access, and utility commands

Installation

pip install replx

Command summary

Connection and session

  • setup: Initialize workspace settings and register a default device.
  • scan: List available serial devices.
  • status: Show session and connection state.
  • fg: Change the foreground device for the current session.
  • whoami: Show the current foreground device.
  • close: Close a device connection while leaving the agent running.
  • agent status|start|stop: Inspect and manage the configured agent.
  • agent connect IP: Connect this workspace to an existing agent.
  • agent disconnect IP: Remove sessions for a client IP.
  • theme: Show or customize UI panel colors and box style.

Execution and interaction

  • exec (-c): Execute inline Python code on the device.
  • run: Run a local or device-side script.
  • repl: Open an interactive REPL session.
  • shell: Open a device file-system shell.

File operations

  • ls: List files and directories.
  • cat: Print file content.
  • get: Download files from device to local.
  • put: Upload files from local to device.
  • cp: Copy files or directories on device.
  • mv: Move or rename files or directories on device.
  • rm: Remove files or directories on device.
  • mkdir: Create directories on device.
  • touch: Create a file if missing; preserve existing contents.

Device management

  • usage: Show device storage usage.
  • reset: Perform a soft reset.
  • format: Format the device file system.
  • init: Run initialization scripts on device.
  • firmware: Check, download, or update firmware.

Package and build

  • mip: Search and install MicroPython packages from the official index or GitHub.
  • pkg: Search, download, and update packages.
  • mpy: Compile .py files to .mpy.

Hardware

  • gpio: Read, write, and run GPIO sequences.
  • pwm: Generate and monitor PWM signals.
  • adc: Read ADC pins and run a board-side scope UI.
  • uart: Open, write, read, and monitor UART.
  • spi: Open, write, read, and transfer SPI data.
  • i2c: Scan, read, write, and dump I2C devices.
  • i2s: Play I2S tones and capture or monitor an I2S microphone.
  • ws2812: Write pixels and regions on WS2812 LED matrices.

Connectivity

  • wifi: Manage Wi-Fi configuration and connection state.
  • ble: Manage BLE radio, scan, advertise, GATT server/client, and L2CAP.

Notes

  • scan, status, whoami, agent, and agent stop do not use the serial --port option.
  • Most device commands can omit the port when a foreground or workspace default device is available.
  • The agent defaults to 127.0.0.1:49153. AGENT_IP and AGENT_PORT are stored in the workspace file .vscode/.replx.
  • Non-loopback binds require the same REPLX_AGENT_TOKEN environment variable on the agent and client. TCP is unencrypted; use a trusted LAN or VPN.
  • Legacy ~/.replx/config, ~/.replx/.config, and ~/.replx/.agent_port settings are read for migration compatibility.
replx agent start --port 49153
replx agent status
replx close
replx agent stop

For a remote agent, set REPLX_AGENT_TOKEN on both machines, then run replx agent connect 192.168.1.20 --port 49153.

License

MIT

Metadata

Release files for replx 2.0.0.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for replx 2.0.0.post1
File Interpreter ABI Platform Actions
replx-2.0.0.post1-py3-none-any.whl Python 3 none any Details for replx-2.0.0.post1-py3-none-any.whl

Release files / replx-2.0.0.post1-py3-none-any.whl

Download URL replx-2.0.0.post1-py3-none-any.whl
Size 464.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
39b20a95cf4c948644d52ca0f18a1899f27399e6cd5f414bbfcc2f62f3bef627
BLAKE2b-256 checksum
How to use checksums
5d58fa4f003b8a2771ce2c65ce72df586b344126624e06c0958cd2628bbcbe7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Security for replx 2.0.0.post1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page