> ## Documentation Index
> Fetch the complete documentation index at: https://zju-a00451d9-feat-personal-agent-team.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# tui

# `velaclaw tui`

Open the terminal UI connected to the Gateway.

Related:

* TUI guide: [TUI](/web/tui)

Notes:

* `tui` resolves configured gateway auth SecretRefs for token/password auth when possible (`env`/`file`/`exec` providers).
* When launched from inside a configured agent workspace directory, TUI auto-selects that agent for the session key default (unless `--session` is explicitly `agent:<id>:...`).

## Examples

```bash theme={null}
velaclaw tui
velaclaw tui --url ws://127.0.0.1:18789 --token <token>
velaclaw tui --session main --deliver
# when run inside an agent workspace, infers that agent automatically
velaclaw tui --session bugfix
```