PIO Agent

Screenshots

Example prompts

• “Inspect and validate this PlatformIO project.”
• “Build, flash with approval, and verify the device output.”
• “Open the PIO Agent dashboard and monitor this device.”

Skills

• esp32-flash-monitor

  Run the common ESP32 workflow in PlatformIO: build, flash, monitor, diagnose, patch, and retry. Use for ESP32/ESP8266/ESP32-S3/ESP32-C3 projects using Arduino or ESP-IDF.

• firmware-bringup

  Bring up a new embedded board or create a minimal working firmware project with PlatformIO. Use when setting up a new project, identifying a connected board, creating a blink or serial smoke test, verifying build/flash/boot, or confirming the board is alive.

• get-started

  Set up PIO Agent in Codex for a first PlatformIO project inspection. Use when a user has just installed the plugin, asks how to start, or needs help checking local prerequisites. Do not use for flashing or unattended hardware actions.

• hardware-in-the-loop-test

  Validate firmware behavior on real hardware rather than compilation-only checks. Use when running physical acceptance tests, confirming boot markers, validating sensor output, or checking runtime timing/telemetry.

• pio-manager

  Execute PlatformIO builds, flashing, monitoring, library management, tests, and port claims through the guarded pio-agent CLI or an existing MCP session. Use for port conflicts, ESP32 port drift, or hardware-less target tests. Do not use for general code editing or unrelated host diagnostics; unsupported hardware recovery requires a local operator.

• platformio-dashboard

  Open and operate the PIO Agent dashboard when the user asks to view projects, devices, logs, approvals, tasks, locks, or monitor state in a visual interface. Do not use for unattended or scheduled runs.

• platformio-debug

  Diagnose and fix PlatformIO build, upload, and configuration failures. Use when resolving compiler errors, missing libraries, platformio.ini issues, memory overflows, port conflicts, permission errors, failed uploads, crash backtraces, or firmware size analysis.

• platformio-monitoring-automation

  Create or update recurring PlatformIO build, device-presence, serial-health, or bounded lab-test monitoring when the user asks to schedule, watch, monitor repeatedly, or receive follow-ups. Do not use for one-time interactive diagnostics.

• serial-diagnostics

  Diagnose embedded runtime behavior through serial logs after build/upload. Use when investigating boot loops, crashes, watchdog resets, panic output, missing boot markers, peripheral initialization issues, or silent serial sessions.