PIOAGENT Get started

SOFTWARE INTELLIGENCE. PHYSICAL POSSIBILITIES.

Give your AI
a 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.

Connect your agent Explore the possibilities

OPEN SOURCE / RUNS LOCALLY / POWERED BY PLATFORMIO

PIO Agent’s chrome robot mascot with glowing blue eyes
Your idea. Real hardware.
CODE → BUILD → FLASH → VERIFY

YOUR FAVORITE AGENT.
A WHOLE NEW TOOLSET.

CodexClaude DesktopClineVS CodeAntigravity

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.

Open source. Local execution. Real possibilities.
Meet PlatformIO-MCP, the engine behind PIO Agent.

Explore the source on GitHub
CONNECT YOUR AGENT01—02

01 / Run this in your terminal

npx platformio-mcp install --codex-plugin

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