Qwik
A cross-platform alias manager that turns one portable store into native commands across your shells.
- Status
- Completed
- Started
- May 2026
- Role
- Creator and maintainer — CLI UX, substitution engine, shell renderers, storage, sync, and packaging.
- Stack
- Python · Typer · TOML · Shell Integration
Define an alias once and use it naturally across shells and machines without hand-maintaining rc files.
What it is
Qwik centralizes shell aliases in a human-readable TOML store, then renders them as native commands for bash, zsh, fish, and PowerShell. Aliases can accept positional or named arguments, include defaults, and be found through an interactive fuzzy picker.
Why I built it
Shell aliases are useful but become fragmented across machines, shell-specific syntax, and hand-edited startup files. Powerful aliases also need careful quoting and conflict checks.
How it addresses the problem
Qwik keeps a single versioned store and a shared substitution engine, then generates shell-native hooks. Atomic writes, backups, migrations, conflict detection, Git sync, and read-only team overlays make the workflow portable without hiding how commands execute.
What the project actually does
Native across shells
Generates real commands for bash, zsh, fish, and PowerShell while the CLI runner works in scripts, CI, and unsupported shells.
Argument templates
Supports positional and named placeholders, defaults, all-argument forms, safe quoting, and extra argument forwarding.
Fast discovery
An interactive fuzzy picker, search, tags, groups, descriptions, and usage statistics keep a large alias collection navigable.
Safe shell integration
Installers are idempotent, back up rc files, and detect collisions with existing aliases, builtins, and binaries.
Portable storage
A versioned TOML store uses atomic writes, automatic migrations, and timestamped backups.
Personal and team sync
Git-backed sync shares personal aliases across machines; read-only overlays distribute team command sets.
How the pieces connect
- 01 CLI / fuzzy picker
- 02 Alias store
- 03 Substitution engine
- 04 Shell renderers
- 05 Native shell hooks
- 06 Git sync / overlays
From zero to a useful result
- 01
Install Qwik
Keep the CLI isolated with pipx or uv.
pipx install qwik - 02
Add an alias
Save a command once in Qwik’s portable alias store.
qwik add gs "git status" - 03
Enable native commands
Install the hook for your shell. New sessions can then run the alias exactly like a built-in command.
qwik init zsh --install
Start from the terminal
pipx install qwik