Profiles

Profiles are named groups of aliases. Think of them as layers — you can activate multiple simultaneously, and later-activated profiles override earlier ones for conflicting alias names.

Creating a Profile

am profile add rust
am p a rust          # short form

Adding Aliases to a Profile

am add -p rust ct "cargo test"
am add -p rust cb "cargo build"

Activating Profiles

# Activate a profile (adds on top of the current stack)
am use rust
am use rust -n 1     # at a specific position (1 = base layer)

Activate multiple profiles at once:

am use git rust node         # activate all three at once
am use git rust -i           # inverse: first listed = highest priority

TIP

am use is a shortcut for am profile use. The long forms am profile use rust and am p u rust also work.

When you activate multiple profiles, they stack. The last-activated profile wins on conflicts:

am use git     # base layer (active: 1)
am use rust    # on top (active: 2)
# If both have alias "t", rust's version wins

Listing Profiles

am profile           # default action
am profile list      # explicit
am l                 # shortest form

Active profiles are shown connected by a tree trunk. Inactive profiles appear below:

🌐 global
│
├─● git (active: 1)
│ gm → git commit -S --signoff -m
│
├─● rust (active: 2)
│ ct → cargo test
│
╰─📁 project (/path/to/project/.aliases)

○ node
  nr → npm run

To show only what is currently in use — active profiles and any loaded project aliases — pass --used:

am l --used
am l -u              # short form
am profile list -u

Inactive profiles are hidden, keeping the output focused when you have many profiles defined.

Removing a Profile

am profile remove rust     # asks for confirmation if it has aliases
am p r rust -f             # skip confirmation

Adding and Removing Aliases

# Add to the currently active profile
am add gs git status

# Add to a specific profile
am add -p rust ct cargo test

# Remove from the active profile
am remove gs
am r gs              # short form

# Remove from a specific profile
am remove -p rust ct

TIP

All verbs have short forms: am a for add, am r for remove, am p a for profile add, am p u for profile use.

Managing Profiles Visually

Use am tui to manage profiles interactively — add aliases, move them between profiles, and see the layered hierarchy at a glance: