AMOXIDE-RS(1)

NAME

amoxide-rsamoxide (am) helps to manage your shell aliases either globally, profile- or project-specific. It loads context…

SYNOPSIS

$brew install sassman/tap/amoxide

INFO

105 stars
2 forks
0 views

DESCRIPTION

amoxide (am) helps to manage your shell aliases either globally, profile- or project-specific. It loads context specific relevant aliases automatically

README

amoxide (am) - alias manager oxidized

amoxide banner

amoxide on crates.io amoxide-tui on crates.io license

If you only have a handful of shell aliases in your dotfiles, you're missing out. amoxide (am) lets you define aliases per project, per toolchain, or globally — and loads the right ones automatically when you cd into a directory. Think direnv, but for aliases.

cd ~/my-rust-project
# cargo test is now: t
# cargo clippy <with-a-lot-of-options> is now: l

cd ~/my-node-project

same aliases, different commands, loaded automatically

the rust ones are gone — no pollution

Screenshots

  • am tui launches the tui to navigate, select, move, add, and delete aliases visually:

am tui

  • am ls the regular cli

am ls

Installation

Homebrew (macOS and Linux)

brew install sassman/tap/amoxide sassman/tap/amoxide-tui

Shell Script (macOS and Linux)

curl -fsSL https://github.com/sassman/amoxide-rs/releases/latest/download/amoxide-installer.sh | sh
curl -fsSL https://github.com/sassman/amoxide-rs/releases/latest/download/amoxide-tui-installer.sh | sh

PowerShell (Windows)

powershell -ExecutionPolicy Bypass -c "irm https://github.com/sassman/amoxide-rs/releases/latest/download/amoxide-installer.ps1 | iex"
powershell -ExecutionPolicy Bypass -c "irm https://github.com/sassman/amoxide-rs/releases/latest/download/amoxide-tui-installer.ps1 | iex"

Cargo (pre-built)

cargo binstall amoxide amoxide-tui

Cargo (from source)

cargo install amoxide amoxide-tui

The crate is called amoxide, but the binary it installs is simply am (short for amoxide).

Shell Support

ShellStatus
FishFully supported and tested
PowerShellSupported and tested (5.1 + 7)
ZshSupported, not yet tested
BashSupported (3.2+)
BrushSupported (bash-compatible)
NushellNot yet implemented

Quick Setup

am setup fish          # or: zsh, bash, brush, powershell

Then add your first alias:

am add -l t cargo test     # project-local alias
am add -p rust t cargo test # profile alias
am add -g ll ls -lha        # global alias

Documentation

Full documentation — usage guides, profiles, project aliases, parameterized aliases, and more:

amoxide.rs

SEE ALSO

clihub4/10/2026AMOXIDE-RS(1)