Start local. Add sync later.

Add an alias and initialize your shell.

Add aliases to the local store, list them, then write the shell integration for the shell you use. After shell integration is active, alias changes refresh in the current shell.

$ aliaz add gs "git status"
Added gs to shared

$ aliaz list
gs	git status

$ aliaz init zsh
Wrote ~/.config/aliaz/aliases.sh
Configured ~/.zshrc

Generate stdout or write managed files.

$ aliaz generate zsh
$ aliaz generate bash
$ aliaz generate fish

$ aliaz init zsh
$ aliaz init bash
$ aliaz init fish

After integration is active, aliaz select opens a searchable alias list and runs the selected command in the current shell.

Import existing zsh-style aliases.

Migration reads lines that start with alias . Commented aliases and shell functions are ignored.

$ aliaz migrate --from ~/.zshrc
$ aliaz migrate

Encrypted sync keeps alias contents client-side.

Alias names and commands are encrypted before upload. The sync server stores encrypted records and metadata, while the recovery phrase stays local and is required to decrypt aliases on a new computer.

Collections sync across machines, while each computer chooses which collections are active locally. The shared collection is always active, so aliases added without --collection continue to work everywhere.

$ aliaz login --username ada
$ aliaz sync
$ aliaz init zsh

Local data stays in standard OS directories.

Aliases are stored in a local SQLite database under the operating system's standard data directory. Sync config is stored under the standard config directory. Recovery phrases are stored in the OS credential store.

Check local state before changing config.

If an alias does not appear in your shell, list aliases, rerun init for your shell, then use doctor. Once integration is loaded, add, edit, rm, collection, migrate, import, and sync refresh aliases automatically.

$ aliaz list
$ aliaz init zsh
$ aliaz doctor