Command-line usage¶
Running wa with no arguments starts the interactive TUI, but the binary also
takes flags and a couple of subcommands that are useful for checking your
config or scripting one-shot prompts:
| Invocation | Effect |
|---|---|
wa |
Start the interactive TUI |
wa list-providers |
List the providers your config defines |
wa list-models |
List the models available across all configured providers |
wa --model <ref> |
Start against a specific [provider/]model[@effort[,think\|,nothink]] |
wa -p "<prompt>" |
Run a single prompt and exit instead of starting the TUI |
wa -c (--continue) |
Continue the most recent session for the current project |
wa --resume <id> |
Resume a specific session by its id (the ULID in the session filename) |
wa --config <path> |
Load a config from <path> instead of ~/.config/wallah/config.lua |
wa doc <action> |
Extract or render Lua reference documentation (see Reference) |
The system prompt can be overridden with --system <text> or --system-file
<path>, or extended with --append-system <text> or --append-system-file
<path>. Both --continue and --resume take their provider, model, and effort
from the stored session, so neither can be combined with --model.
After editing your config, wa list-providers and wa list-models are a quick
way to confirm it loads and that every provider is reachable. Run wa --help
for the full list of flags.