# Install teensy_loader_cli with Homebrew, apt, Nix, pacman

Command-line integration for Teensy USB development boards. Version 2.3 via Homebrew; verified from local package data. Also installable with debian: sudo apt install teensy-loader-cli.

## Install

```sh
sudo av install brew:teensy_loader_cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install teensy_loader_cli
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install teensy-loader-cli
```

  Evidence: Debian stable package indexes: teensy-loader-cli from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#teensy-loader-cli
```

  Evidence: nixpkgs package indexes: pkgs/by-name/te/teensy-loader-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S teensy_loader_cli
```

  Evidence: Arch Linux sync databases: teensy_loader_cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:teensy_loader_cli
- **Package manager:** Homebrew
- **Version:** 2.3
- **Source summary:** Command-line integration for Teensy USB development boards
- **Homepage:** <https://www.pjrc.com/teensy/loader_cli.html>
- **Repository:** <https://github.com/PaulStoffregen/teensy_loader_cli>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- teensy_loader_cli (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.3
## Project history and usage

Teensy Loader CLI is the command-line loader for PJRC Teensy development boards. It exists for advanced users who want to automate firmware programming from Makefiles, scripts, CI jobs, or other non-GUI workflows.

### Project history

PJRC documents the CLI as the command-line counterpart to the graphical Teensy Loader. The official page says it is for advanced users who want to automate programming, typically with a Makefile, while the GUI in automatic mode is easier for most use.

The README and PJRC page preserve an older cross-platform development history: version 2.0 was tested on Ubuntu 9.04, Mac OS X 10.5, Windows XP, FreeBSD 8.0, OpenBSD snapshots, and NetBSD 5.0.1. Later version 2.1 added Teensy 3.5 and 3.6 support and Windows support for all Teensy boards, while the Git tags show releases through 2.3.

### Adoption history

The tool was adopted by embedded developers who needed to flash Teensy boards without opening the desktop loader. Its package-manager presence matters because headless or scripted development environments need a reliable `teensy_loader_cli` binary plus platform setup such as Linux udev rules.

The README also records automation patterns beyond local Makefiles, including a hard reboot option using a second Teensy and a note that PlatformIO includes support for loading via `teensy_loader`.

### How it is used

Typical usage is invoking `teensy_loader_cli --mcu=<target> -w firmware.hex` after building a `.hex` file. Users select the target MCU or logical Teensy board, optionally wait for a board to appear, reboot or avoid rebooting, and use verbose output for troubleshooting.

Package users care because it turns physical board programming into a scriptable post-build step. It is especially useful for command-line-only setups, repeatable firmware workflows, and build systems that already know the board's MCU name.

### Why package nerds care

Teensy Loader CLI is a small but important hardware-adjacent package: it bridges package-managed build tools and an actual USB bootloader. Its significance is not breadth but reliability at the final step of embedded development, where a script must put bytes onto a board.

### Timeline

- 2010: Version 2.0-era documentation lists testing on Ubuntu 9.04, Mac OS X 10.5, Windows XP, FreeBSD 8.0, OpenBSD, and NetBSD.
- Version 2.1: Added Teensy 3.5 and 3.6 support plus Windows support for all Teensy boards.
- Version 2.3: Latest tag shown in the official Git repository.

### Related projects

- Related projects include Teensyduino, the graphical Teensy Loader, PlatformIO, AVR/ARM Makefile workflows, and PJRC Teensy hardware boards.

### Sources

- <https://github.com/PaulStoffregen/teensy_loader_cli/blob/master/README.md>
- <https://github.com/PaulStoffregen/teensy_loader_cli/releases>
- <https://www.pjrc.com/teensy/loader_cli.html>
- source_facts.description


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Other Package-Manager Records

- Debian apt - teensy-loader-cli - 2.2-1.1: normalized package name match | Debian stable package indexes: teensy-loader-cli from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | load and run programs onto your Teensy micro controller | https://www.pjrc.com/teensy/loader_cli.html
- Nix - teensy-loader-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/teensy-loader-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - teensy-loader-cli - 2.2-1: normalized package name match | Ubuntu 24.04 LTS package indexes: teensy-loader-cli from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | load and run programs onto your Teensy micro controller | https://www.pjrc.com/teensy/loader_cli.html
- pacman - teensy_loader_cli - 2.3-1: normalized package name match | Arch Linux sync databases: teensy_loader_cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Command line loader for the teensy microprocessor boards | https://www.pjrc.com/teensy/loader_cli.html


## Combined YAML source

View the package source record on GitHub. [combined/teensy_loader_cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/teensy_loader_cli.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
