usagio
Latest release

Install usagio

macOS, Linux, and Windows are all supported. On macOS and Linux, one Homebrew command puts the binary on your PATH and the tray app in your menu bar.

Recommended

macOS

Installs the binary, wires up the menu-bar agent, and auto-launches it on login. Upgrades come through brew upgrade; a running app relaunches into the new binary without you restarting anything.

$ brew tap --trust mattjackson/tap
$ brew install mattjackson/tap/usagio
$ usagio install

The first two commands add the tap and install the binary; usagio install registers the menu-bar app and auto-swap daemon to start on every login.

All releases on GitHub →

Prefer a manual install? Grab the archive directly:Apple Silicon (.tar.gz) ·Intel (.tar.gz)

Linux

Homebrew (linuxbrew) or tarball

The same tap works on Linux via linuxbrew. Prefer not to install Homebrew? Grab the tarball directly from the releases page instead.

$ brew tap --trust mattjackson/tap
$ brew install mattjackson/tap/usagio
$ usagio install

This adds the tap, installs the binary, and registers the tray app and auto-swap daemon to start on every login.

Or, without Homebrew, download the tarball from the releases page, then extract and run it directly:

$ tar xzf usagio-0.5.0-x86_64-unknown-linux-gnu.tar.gz
$ ./usagio watch

To register the tray app and auto-swap daemon at login, run ./usagio install. (See the FAQ for what that writes to disk.)

Download tarball (x86_64) ↓
Windows

Prebuilt archive

Download usagio-0.5.0-x86_64-pc-windows-msvc.zip, extract it to %LOCALAPPDATA%\Programs\usagio\, and add that folder to your PATH. Then run:

> usagio install

Adds usagio to your PATH and enables autostart at login. See theFAQ for SmartScreen and antivirus notes.

Download zip (x86_64) ↓

Verify the install

Confirm the binary is on your PATH and the version matches what you expected.

$ usagio --version
$ usagio status
Requires
macOS 13 Ventura or later · Apple Silicon or Intel. Uses the macOS Keychain and launchd.
Linux · x86_64. Needs GTK 3,libayatana-appindicator3, libsecret, and an xdg-desktop-portal for the tray icon, credential storage, and autostart entry respectively.
Windows 10 or later · x86_64. Uses Windows Credential Manager and the Autostart Registry key.

See release notes for per-OS details and known limitations.

Build from sourceRust 1.88+ · single cargo build

Requires a recent stable Rust toolchain. The MSRV is 1.88. The workspace builds one binary that powers both the menu-bar app and the CLI.

$ git clone https://github.com/MattJackson/usagio.git
$ cd usagio
$ cargo build --release
$ cp target/release/usagio /usr/local/bin/
$ usagio install

The binary lands at target/release/usagio; copy it anywhere on your PATH.

Contributing? The repo README covers the layout, tests, and the provider-adapter interface for adding new AI coding CLIs.