5. CLI entry points
[!ref] Full details in the User Manual, "Download, run and system requirements".
The CLI version shares sessions and config with the desktop; they can hand work back and forth.
5.1 Main subcommands
| Command | Purpose |
|---|---|
avl tui |
Launch the TUI in your terminal, sharing sessions with the desktop |
avl zagent-tui |
Launch the batch-mode conversation TUI; useful for scripting |
avl workspace |
Workspace operations |
avl agent |
One-shot LLM conversation (JSONL batch) |
avl skill |
Skill management and signing |
avl channel |
Companion messaging (standalone / dry-run / callback mode) |
avl mcp |
External tool service debug |
avl install |
Install the 5 subcommand symlinks into the current directory |
tui/zagent-tuiare built into the main binary; no separate zBoxFull install needed.
5.2 Common args
| Arg | Meaning |
|---|---|
| `--workspace <id | path>` |
--config <path> |
Explicit config directory |
--log-level <level> |
error / warn / info / debug |
--no-color |
Disable colour output |
-h / --help |
Help |
-V / --version |
Version |
5.3 Exit codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Generic error |
| 2 | Argument error |
| 64 | Config error |
| 65 | Data error |
| 69 | Service unavailable |
| 70 | Software error (please report) |