asdf-arduino-cli

arduino-cli plugin for asdf and mise. This plugin is NOT maintained or supported by the Arduino project.

Contents

• Dependencies
• Install
• Configuration
• Contributing
• License

Dependencies

• bash, curl, tar, and POSIX utilities.

Install

Plugin:

asdf plugin add arduino-cli https://github.com/egnor/asdf-arduino-cli.git

arduino-cli:

# Show all installable versions
asdf list-all arduino-cli

# Install specific version
asdf install arduino-cli latest

# Set a version globally (on your ~/.tool-versions file)
asdf global arduino-cli latest

# Now arduino-cli commands are available
arduino-cli version

See asdf and/or mise documentation for more on installing and managing versions.

Configuration

By default, arduino-cli stores configuration and cache files in ~/.arduino15 and sketches in ~/Arduino. If you're using a version manager you probably want something more hermetic; consider setting $ARDUINO_DIRECTORIES_DATA, $ARDUINO_DIRECTORIES_USER, $ARDUINO_CONFIG_FILE, and/or other variables to local project-specific directories.

If you're using mise, you can put something like this in .mise.toml:

[env]
ARDUINO_DIRECTORIES_DATA = "{{config_root}}/arduino_data"
ARDUINO_DIRECTORIES_USER = "{{config_root}}/arduino_user"
ARDUINO_CONFIG_FILE = "{{config_root}}"

You'd likely want arduino_data/ in .gitignore.

Note that $ARDUINO_CONFIG_FILE points to a directory, not the config file itself; the actual file must be named arduino-cli.{yaml,toml,json,...}.

Contributing

Contributions of any kind are welcome! See the contributing guide.

License

See LICENSE © Daniel Egnor