Command reference

Small verbs, predictable output.

Aliaz keeps the open-source command surface compact: local alias CRUD, shell output, migration, JSON portability, optional sync, logout, and health checks.

Local aliases

Add, list, edit, and remove aliases.

local store
$ aliaz add gs "git status"
Added gs

$ aliaz list
gs	git status

$ aliaz edit gs "git status --short"
Updated gs

$ aliaz rm gs
Deleted gs
Shell output

Print definitions or write integration files.

Supported shell values are zsh, bash, and fish. generate prints to stdout; init writes managed files.

Generate

$ aliaz generate zsh
alias gs='git status'

Initialize

$ aliaz init fish
Wrote ~/.config/fish/conf.d/aliaz.fish

For zsh and bash, init also updates the startup file once. The managed integration refreshes aliases after successful add, edit, rm, migrate, import, and sync commands.

Portability

Migrate, export, and import.

Use migration for zsh-style alias files, and JSON import/export when you want a portable file.

portable aliases
$ aliaz migrate --from ~/.zshrc
$ aliaz export --output aliases.json
$ aliaz import aliases.json
Reference

Current command surface.

Command Purpose Notes
add <name> <command> Create or update an alias. Names allow ASCII letters, numbers, _, -, and ..
list Print active aliases. Output is tab-separated.
edit <name> <command> Update an alias command. Fails if the alias does not exist.
rm <name> Delete an alias. delete is accepted as an alias.
migrate --from <path> Import zsh-style aliases. Defaults to ~/.zshrc.
generate <shell> Print shell aliases. Does not write files.
init <shell> Write managed shell files. zsh and bash update the startup file once.
export --output <path> Export aliases as JSON. Prints JSON when no output path is provided.
import <path> Import exported JSON. Upserts by alias name.
register --username <name> Create a sync account. Prompts for a password and prints a recovery phrase.
login --username <name> Configure sync on another machine. Prompts for the password and recovery phrase.
sync Pull and push encrypted alias records. Requires register or login first.
logout Remove local sync config and recovery material. Does not delete server-side account data.
status Report alias and sync state. Shows pending sync records.
doctor Check local setup. Checks database, integration files, sync config, and secrets.