Skip to content

Latest commit

 

History

101 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

waz

Warp-style command prediction and a command palette for any terminal (Ghostty, Alacritty, Kitty, iTerm2, WezTerm, …). Ghost-text suggestions, a TUI, and optional AI — not the Warp terminal fork.

Inspired by Warp’s multi-tier prediction approach.

Tier What it uses
0 Output hint (waz hint)
1 Command sequences from history (stemmed)
2 Workflows (mkdircd, git commitgit push when a remote exists, …)
3 Directory history
4 LLM (optional)

Ghost text can appear on an empty prompt: the next command, not the one you just ran. Failed commands skip sequence/workflow.

Full guides: docs/ · usage · AI · plugins · TMP

Install

make install
# or: cargo install waz

make install puts the binary in ~/.cargo/bin and ~/.local/bin.

From a clone:

cargo build --release
cp target/release/waz ~/.local/bin/

Getting started

Add one line to your shell (quotes required for Zsh/Bash):

Zsh (~/.zshrc): eval "$(waz init zsh)"
Bash (~/.bashrc): eval "$(waz init bash)"
Fish: waz init fish | source
PowerShell ($PROFILE): Invoke-Expression (& waz init powershell | Out-String)

waz init pwsh and waz init ps1 are the same as powershell.

Optional — Ghostty Cmd+I for the palette:

keybind = super+i=text:\x1b[119;97;122~

Import existing history:

waz import
waz import --shell zsh
waz import --shell powershell

Basic usage

Shell Suggestion Palette
Zsh Dim ghost text; accept, Alt+F next word Ctrl+T
Bash / Fish / PowerShell Ctrl+Space fill Ctrl+T
waz tui                    # palette: / TMP · ! shell · other text = AI
waz predict --cwd .
waz stats
waz doctor --cwd .

TUI keys, run / runnables, and the rest of the CLI: docs/usage.md.

AI, OAuth, local models, OpenAI/Gemini/Anthropic-compatible APIs: docs/ai.md.
Codex / Claude Code / Gemini CLI plugin: docs/plugins.md.
Schemas and waz generate: docs/tmp.md.

License

MIT

About

Bring Warp Intelligence to your terminal

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages