zsh-alias-manager (zam)

A CLI tool to manage your zsh aliases with tags, search, backups, and an interactive mode.

Installation

npm install -g zsh-alias-manager

Usage

# Interactive mode (default)
zam

# Add an alias
zam add gs "git status"
zam add gp "git push" --tag git

# List aliases
zam list
zam list --tag git

# Search with highlighting
zam search git

# Rename an alias
zam rename gs gst

# Remove an alias
zam remove gst

# Edit in $EDITOR
zam edit gs

# Backup & restore
zam backup
zam backups
zam restore ~/.zam/backups/zam-backup-2024-01-01.bak

# Import existing aliases from .zshrc
zam import

# Dry run (simulate without changes)
zam --dry-run add test "echo test"

Features

• Interactive mode - Fuzzy search and menu-driven interface
• Tags - Organize aliases by category (git, docker, etc.)
• Search - Find aliases with highlighted matches
• Backups - Automatic backup management in ~/.zam/backups/
• Import - Migrate existing aliases from .zshrc
• Dry run - Preview changes before applying

File Locations

• ~/.zsh_aliases_managed - Your aliases (sourced by zshrc)
• ~/.zam/metadata.json - Tags and metadata
• ~/.zam/backups/ - Backup files

License

MIT