Skip to content

Repository files navigation

Autonomix CLI

Website: https://autonomix-cli.ninepointlabs.com

Autonomix CLI is a terminal-based utility written in Go that allows you to easily install and manage applications directly from GitHub Releases.

Features

  • Install from GitHub: Add any GitHub repository URL to track.
  • Auto-Detection: Recognizes .deb, .rpm, .flatpak, .snap, .appimage, and Arch packages.
  • Smart Updates: Checks for new releases on GitHub.
  • System Integration: Detects if the application is already installed on your system (dpkg, rpm, pacman, flatpak, snap) and shows the installed version.
  • TUI: Simple and easy-to-use Terminal User Interface built with Bubble Tea.

Installation

From GitHub Releases

Go to the Releases page and download the package for your system.

Debian/Ubuntu:

sudo dpkg -i autonomix-cli_*.deb

Fedora/RHEL:

sudo rpm -i autonomix-cli_*.rpm

Arch Linux:

sudo pacman -U autonomix-cli_*.pkg.tar.zst

Any Linux (tarball): download autonomix-cli_Linux_x86_64.tar.gz (or _arm64) and put the autonomix-cli binary on your PATH:

tar -xzf autonomix-cli_Linux_x86_64.tar.gz autonomix-cli
install -m755 autonomix-cli ~/.local/bin/

Keeping it updated with autonomix-cli

Once installed, Autonomix CLI tracks itself automatically (there's no need to add it), so autonomix-cli update picks up new releases. To track another app, add its repository:

autonomix-cli add https://github.com/ninepointlabs/repokase

Omarchy bar widget

omarchy-autonomix puts your tracked apps and their updates in the Omarchy bar, using the --json commands below.

Usage

Run the application:

autonomix-cli

Commands

autonomix-cli add <url>             # Track a GitHub repository (URL or owner/repo)
autonomix-cli list                  # List tracked apps and what's installed (no network)
autonomix-cli check [app...]        # Check tracked apps for updates
autonomix-cli update [-y] [app...]  # Install available updates (-y: don't ask)
autonomix-cli install <app>         # Install a tracked app that isn't installed yet
autonomix-cli remove <app>          # Stop tracking an app (does not uninstall it)
autonomix-cli about                 # Version, license, support and privacy
autonomix-cli --version

<app> can be the app name, repo name, owner/repo or the repository URL.

update only touches apps installed through the system package manager (dpkg, rpm, pacman). Apps found only as a binary on PATH, or via Flatpak/Snap, are reported and skipped.

JSON output

Add --json to add, list, check, update, install or remove to get machine-readable output on stdout, for scripts and graphical frontends. Progress messages go to stderr, --json implies -y, and errors are printed as {"error": "..."} with exit code 1. Each app looks like this:

{
  "name": "Repokase",
  "repo": "ninepointlabs/repokase",
  "repo_url": "https://github.com/ninepointlabs/repokase",
  "status": "update_available",
  "installed": "0.2.1-1",
  "installed_type": "pacman",
  "latest": "v0.2.2",
  "release_url": "https://github.com/ninepointlabs/repokase/releases/tag/v0.2.2",
  "last_checked": "2026-10-14T12:00:00-05:00"
}

status is one of up_to_date, update_available, not_installed, unmanaged (installed outside the system package manager), unchecked (installed, no release fetched yet) or failed (with error). After update or install, apps that were installed have "updated": true.

When stdin isn't a terminal, packages are installed with pkexec instead of sudo, so a graphical frontend gets a polkit password dialog. update downloads every update first, then installs them all with one command, so the password is asked for once.

Set GITHUB_TOKEN (or GH_TOKEN) to raise the GitHub API rate limit from 60 to 5000 requests per hour.

Omarchy

To update Autonomix apps whenever you run omarchy update, install the post-update hook:

install -m755 contrib/omarchy/autonomix.hook ~/.config/omarchy/hooks/post-update.d/autonomix.hook

Controls

  • Start Typing: To add a new GitHub repository URL.
  • Enter: Confirm adding a repo.
  • u: Check for updates for the selected app.
  • d: Delete/Remove an app from the list (stops tracking).
  • i: About Autonomix CLI.
  • q / Ctrl+C: Quit.

About

Press i in the TUI (it's listed in the help bar), or run autonomix-cli about, to see the version, license, Nine Point Labs, the support address help@ninepointlabs.com and what Autonomix CLI does with your data. In the TUI, l shows the full license, e starts an email with your version details filled in and c copies the address (with wl-copy, xclip or xsel).

Configuration

Configuration is stored in ~/.autonomix/config.json.

building

go build

Releases

Packages

Contributors

Languages