edesto-dev 0.6.0

Teach AI coding agents to compile, flash, and validate firmware on real hardware. One command to bridge any agent and any board.

edesto-dev

Teach AI coding agents how to compile, flash, and validate firmware on your hardware.

AI coding agents stop at the terminal. edesto init gives them the full embedded development loop — compile, flash, read serial output, iterate — so they can autonomously develop and debug firmware on real hardware. Works with Claude Code, Cursor, Codex, and OpenClaw.

https://github.com/user-attachments/assets/f1d4719d-ed60-406e-a274-0b0f2b06ac21

Install

pipx install edesto-dev

Quick Start

# 1. Plug in your board and run:
edesto init

# 2. Open your AI coding agent in the same directory

# 3. Tell it what to do:
# "The sensor readings are wrong. Find and fix the bug."

That's it. edesto init auto-detects your board, serial port, and toolchain. It generates a SKILLS.md that teaches your agent the write/compile/flash/validate loop, with board-specific pin references, pitfalls, and serial conventions.

You can also specify everything manually:

edesto init --board esp32 --port /dev/cu.usbserial-0001
edesto init --board esp32 --port /dev/ttyUSB0 --toolchain arduino

JTAG/SWD Flashing

If your board is connected through a JTAG debugger (ST-Link, J-Link, CMSIS-DAP) instead of USB serial:

edesto init --board stm32-nucleo --upload jtag

This walks you through selecting your debug probe and target chip, generates an OpenOCD-based flash command, and optionally configures a serial port for monitoring. If you run edesto init with no USB boards detected and OpenOCD installed, it will offer JTAG setup automatically.

How It Works

edesto init detects your project and generates a SKILLS.md (plus copies as CLAUDE.md, .cursorrules, and AGENTS.md) that gives your AI agent:

1. Compile and flash commands for your specific toolchain
2. A debugging toolkit — serial output reading, plus auto-detected support for logic analyzers, JTAG/SWD, and oscilloscopes
3. Board-specific pin references, capabilities, and common pitfalls
4. Troubleshooting guidance for common failures (port busy, baud mismatch, upload timeout)

The debugging step is what makes this work. Your firmware prints structured serial output ([READY], [ERROR], [SENSOR] key=value) and the agent reads it to verify its own changes on real hardware. When you have additional debug tools installed, the agent can also drive them programmatically.

Supported Toolchains

Toolchain	Detection	Commands
Arduino	.ino files	arduino-cli compile, arduino-cli upload
PlatformIO	platformio.ini	pio run, pio run --target upload
ESP-IDF	CMakeLists.txt + sdkconfig	idf.py build, idf.py flash
MicroPython	boot.py / main.py	mpremote connect, mpremote cp
Custom	edesto.toml	Your commands

If edesto can't detect your toolchain, it prompts you to enter compile/upload commands and saves them to edesto.toml for next time.

Supported Boards

Slug	Board
esp32	ESP32
esp32s3	ESP32-S3
esp32c3	ESP32-C3
esp32c6	ESP32-C6
esp8266	ESP8266
arduino-uno	Arduino Uno
arduino-nano	Arduino Nano
arduino-mega	Arduino Mega 2560
rp2040	Raspberry Pi Pico
teensy40	Teensy 4.0
teensy41	Teensy 4.1
stm32-nucleo	STM32 Nucleo-64

Any board works with PlatformIO, ESP-IDF, MicroPython, or a custom toolchain — the table above is for Arduino auto-detection. Run edesto boards to see the full list.

Debug Tools (Optional)

edesto auto-detects debug tools on your machine and includes them in the generated SKILLS.md. The agent picks the right tool for the problem:

Tool	What it checks	Detection
Serial output	Application behavior (always included)	pyserial
Logic analyzer	SPI/I2C/UART protocol timing and bus decoding	Saleae Logic 2 + logic2-automation Python package
JTAG/SWD	CPU state, crashes, HardFaults, registers, memory	openocd on PATH
Oscilloscope	Voltage levels, PWM frequency/duty, rise times	SCPI scope + pyvisa Python package

If a tool isn't installed, its section is simply omitted — the agent won't try to use it. Run edesto doctor to see which tools are detected.

Commands

edesto init                                     # Auto-detect everything
edesto init --board esp32                       # Specify board, auto-detect port
edesto init --board esp32 --port /dev/ttyUSB0   # Fully manual
edesto init --board stm32-nucleo --upload jtag  # Flash via JTAG/SWD
edesto init --toolchain platformio              # Force a specific toolchain
edesto boards                                   # List supported boards
edesto boards --toolchain arduino               # Filter by toolchain
edesto doctor                                   # Check your environment

Examples

Three example projects in examples/, each with an intentional bug for your AI agent to find and fix:

• sensor-debug — Temperature sensor with a unit conversion bug. Celsius values are correct but Fahrenheit readings are off.
• wifi-endpoint — ESP32 HTTP server where /health returns JSON with the wrong Content-Type header.
• ota-update — ESP32 with OTA support. The agent updates the version string and pushes firmware wirelessly.

Prerequisites

• A supported board connected via USB or JTAG debugger
• Python 3.10+
• Your toolchain's CLI installed (e.g., arduino-cli, pio, idf.py, mpremote)
• For JTAG flashing: openocd on PATH
• Optional: debug tools (logic2-automation, openocd, pyvisa) for advanced debugging

Run edesto doctor to check your setup.

About

Built by Edesto. We build tools for robotics and embedded teams.