# 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](https://x.com/BHolmesDev/status/2025588198571757892).
| Tier | What it uses |
|------|----------------|
| 0 | Output hint (`waz hint`) |
| 1 | Command sequences from history (stemmed) |
| 2 | Workflows (`mkdir` → `cd`, `git commit` → `git 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/](docs/README.md)** · [usage](docs/usage.md) · [AI](docs/ai.md) · [plugins](docs/plugins.md) · [TMP](docs/tmp.md)
## Install
```bash
make install
# or: cargo install waz
```
`make install` puts the binary in `~/.cargo/bin` and `~/.local/bin`.
From a clone:
```bash
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:
```bash
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** |
```bash
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](docs/usage.md)**.
AI, OAuth, local models, OpenAI/Gemini/Anthropic-compatible APIs: **[docs/ai.md](docs/ai.md)**.
Codex / Claude Code / Gemini CLI plugin: **[docs/plugins.md](docs/plugins.md)**.
Schemas and `waz generate`: **[docs/tmp.md](docs/tmp.md)**.
## License
MIT