PIO AGENTHARDWARE INTELLIGENCE Get started

Give your AI
hardware
instinct.

From a conversation to firmware running on your board. PIO Agent gives your AI the tools to discover, build, flash, and verify real hardware.

TACTILE INTERFACESCONCEPT STUDY

Preparing the concept…

Explore the board and library notes below.

The lid is the switch.

01 / 05

A copper contact. A ring of light. Turn a simple gesture into an interface.

THE BOARD
ESP32-S3 Arduino · copper-pad input
THE LIBRARIES
Adafruit NeoPixel ↗Addressable light, with GPIO contact sensing.

WORKS WITH

CodexClaude DesktopClineVS CodeAntigravity

Build with Codex.

The Codex plugin brings firmware workflows, a local dashboard, and hardware verification into your development session.

Set up Codex
Workflow skills
Bring-up, diagnostics, serial monitoring, and hardware verification.
A view of the bench
Open the local dashboard to inspect devices, tasks, logs, and approvals.
One connected loop
Discover. Build. Ask before flashing. Check what actually booted.
Codex plugin guide

01 / FROM PROMPT TO PROTOTYPE

Ideas shouldn’t stop
at the screen.

A board on your desk. An idea in your head.
Give your agent a way to connect the two.

agent × physical worldEXAMPLE

YOU

“Find my ESP32, create a blink project, and check that it boots.”

01 Discover connected boards

02 Initialize project & build firmware

03 Request approval to flash

04 Monitor serial output for BOOT_OK

A first boot you can verify.

Illustrative workflow · results depend on your hardware

02 / A BRIDGE TO THE BENCH

Less friction.
More “it’s alive.”

Find your footing.

Discover devices, identify boards, and inspect project readiness before the first build.

DISCOVERY + SETUP

Close the loop.

Build, diagnose, flash, and read serial output through a connected workflow your agent can follow.

BUILD + DIAGNOSE

Keep your hands on it.

Policy checks, approval gates, port locks, and audit logs keep hardware actions visible and controlled.

POLICY + VISIBILITY

03 / YOUR BENCH. MISSION CONTROL.

Let the agent work.
Stay in the loop.

Follow tasks, inspect logs, and see what’s connected. The local dashboard gives you a front-row seat to your hardware workflow.

Explore the documentation
THE LOCAL DASHBOARDYOUR MACHINE / YOUR HARDWARE
PlatformIO MCP dashboard showing an upload task, firmware logs, and the connected hardware rack
PlatformIO-MCP dashboard · firmware logs, task activity, and connected devices.

04 / YOUR NEXT BUILD STARTS HERE

Plug in.
Think bigger.

Install PIO Agent for your preferred AI host.

Explore the source on GitHub
CONNECT YOUR AGENT01—02

01 / Run this in your terminal

codex plugin marketplace add jl-codes/platformio-mcp --ref main codex plugin add platformio-mcp@platformio-mcp

02 / Restart your host or start a new Codex task

“What boards are connected, and is this project ready to build?”

Requires Node.js 20+ and PlatformIO Core for hardware workflows. A compatible connected board is needed to flash and verify.

Full setup guide

Send your agent the field guide.

Capabilities, requirements, install commands, and MCP configuration. Available as a guide, plain text, and structured metadata.

Agent field guidellms.txt