Shell Setup

Guided Setup (Recommended)

The easiest way to set up amoxide:

Fish

am setup fish

Zsh

am setup zsh

PowerShell

am setup powershell

Bash (v0.4.0+)

am setup bash

Brush

am setup brush

This detects your profile file, shows exactly what it will add, and asks for confirmation.

Manual Setup

Add the init line to your shell configuration:

Fish

# ~/.config/fish/config.fish
am init fish | source

Zsh

# ~/.zshrc
eval "$(am init zsh)"

PowerShell

# Add to your PowerShell profile (echo $PROFILE to find it)
(am init powershell) -join "`n" | Invoke-Expression

Bash (v0.4.0+)

# ~/.bashrc
eval "$(am init bash)"

Brush

# ~/.brushrc
eval "$(am init brush)"

Bash / Brush load order

If you use starship, oh-my-bash, or bash-it, add the am init line after their initialization. This ensures amoxide's cd hook isn't overwritten.

What the Init Does

The am init command does two things:

1. Loads aliases from your active profiles into the current shell
2. Installs a cd hook that automatically loads/unloads project aliases (from .aliases files) when you change directories

Reinitialising Without Restarting

In the rare case that you have edited the config files directly (rather than using am or the TUI) and want the changes applied to your current shell session without opening a new terminal, use the -f / --force flag:

Fish

am init -f fish | source

Zsh

eval "$(am init -f zsh)"

PowerShell

(am init -f powershell) -join "`n" | Invoke-Expression

Bash

eval "$(am init -f bash)"

This unloads all previously defined aliases first, then reloads everything fresh — the same result as opening a new shell, but without leaving your current session.

Verify Setup

Check that everything is configured correctly:

am status

This verifies that the shell hook is installed and your profiles are loaded.