ARDUINO-CLI-DEBUG(1)

📦
version 1.5.1 · 2 versions
, in ubuntu stonking

💖 arduino-cli-debug — Debug Arduino sketches 💖

okay bestie, welcome to ARDUINO COMMAND LINE MANUAL(1), section 1, and this is the glow-up page for arduino-cli-debug. no cap, this is where you debug your Arduino sketches and feel like a main character while doing it. 🦋

✨ SYNOPSIS ✨

arduino-cli debug [flags]

🌸 DESCRIPTION 🌸

Debug Arduino sketches. and like, not just "stare at it and hope" debug — this command opens an interactive gdb session. it's giving detective era, it's giving breakpoints and vibes. 🔥

heads up babes: arduino-cli debug literally launches an interactive gdb session, so your terminal is about to become the whole entire personality. 💅

👑 OPTIONS 👑

  • --board-options=[] — a list of board options, separated by commas. or fr fr you can just pass it multiple times if you've got multiple options. lowkey flexible. ✨
  • --build-path="" — the directory that contains the binaries for debug. the build goes here, the debugging happens here, it's a whole thing. 🎀
  • --debug-property=[] — override a debug property with a custom value you pick. can be used multiple times for multiple properties, so go off. 💅
  • --discovery-timeout=1s — max time to wait for port discovery. like e.g.: 30s, 1m. patience is a virtue but also there's a limit. ⏳
  • -b, --fqbn="" — Fully Qualified Board Name, e.g.: arduino:avr:uno. yes bestie, the whole entire government name. 👑
  • -h, --help[=false] — help for debug. the classic. the icon. press it when you're lost. 🙈
  • -I, --info[=false] — Show metadata about the debug session instead of starting the debugger. so it's the trailer, not the movie. no gdb gets launched, you just get the tea. ☕
  • --input-dir="" — directory containing binaries for debug.
  • --interpreter="console" — the debug interpreter, e.g.: console, mi, mi1, mi2, mi3. pick your fighter. 🎮
  • -p, --port="" — Upload port address, e.g.: COM3 or /dev/ttyACM2. it's the lil address where your board lives. 🏠
  • -m, --profile="" — Sketch profile to use.
  • -P, --programmer="" — Programmer to use, e.g: atmel_ice. slay, a named programmer. 🔌
  • -l, --protocol="" — Upload port protocol, e.g: serial.

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these ones aren't even from this command, they're the family heirlooms. still yours to use tho. 💜

  • --additional-urls=[] — Comma-separated list of additional URLs for the Boards Manager.
  • --config-dir="" — Sets the default data directory (Arduino CLI will look for configuration file in this directory).
  • --config-file="" — The custom config file (if not specified the default will be used).
  • --json[=false] — Print the output in JSON format. for when you want your data machine-readable and your soul unbothered. 🤖
  • --log[=false] — Print the logs on the standard output.
  • --log-file="" — Path to the file where logs will be written.
  • --log-format="text" — The output format for the logs, can be: text, json.
  • --log-level="info" — Messages with this level and above will be logged. Valid levels are: trace, debug, info, warn, error, fatal, panic. that's the whole ladder, climb it. 🪜
  • --no-color[=false] — Disable colored output. (why would you. but okay. no judgment.) 🌈

🌟 EXAMPLE 🌟

here's the vibe, copy-paste ready, character for character:

debian/build/bin/arduino-cli debug -b arduino:samd:mkr1000 -P atmel_ice /home/user/Arduino/MySketch

board? arduino:samd:mkr1000. programmer? atmel_ice. sketch? /home/user/Arduino/MySketch. ate. 💅

🫶 SEE ALSO 🫶

go read your siblings too, they're iconic in their own right. ✨

🎀 HISTORY 🎀

15-Aug-2026 — Auto generated by spf13/cobra.

okay that's the whole page bestie!! 💖 this was Auto generated by spf13/cobra, dated Aug 2026, and it's page 1 of the ARDUINO COMMAND LINE MANUAL(1). now go forth and debug, you absolute legend. ⭐🦋 no cap, you've got this. 💜

📦 where this page comes from