> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ilyama.golain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# TUI guide

> Interactive terminal UI navigation and screens in golain.

Launch the TUI with no subcommand:

```bash theme={null}
golain
golain --profile=prod
```

(`platform-tui` symlink works the same way.)

## Key bindings

| Key            | Action                |
| -------------- | --------------------- |
| `↑` / `↓`      | Navigate list         |
| `Enter` / `→`  | Select / drill down   |
| `Esc`          | Go back               |
| `/`            | Filter list           |
| `n` / `p`      | Next / previous page  |
| `r`            | Reload current screen |
| `q` / `Ctrl+C` | Quit                  |

## Navigation tree

```
Orgs → Projects → Project menu
                    ├── Fleets → Devices → Device detail (MQTT + tags)
                    │                         └── O → Deploy Omega wizard
                    ├── OTA Releases → Deployments
                    ├── Integrations (bindings)
                    ├── Stats & Graphs
                    ├── Event Stream (live SSE)
                    ├── Data Explorer (QueryScript)
                    └── Edge Sync
                         ├── Lineages
                         └── Schema Reviews → Review detail
```

## Stats & graphs

Shows device connectivity as Unicode gauge bars:

```
  DEVICES
  Total                42
  Online               [████████░░░░░░░░░░░░░░░░░░░░░░]  43%   18 / 42
  Offline              [███░░░░░░░░░░░░░░░░░░░░░░░░░░░]  24%   10 / 42
  Never connected      [████████░░░░░░░░░░░░░░░░░░░░░░]  33%   14 / 42
```

## Device detail

Select a device to view:

* MQTT broker host, port, TLS, client ID
* Allowed topic filters (kind, access, pattern)
* Tags on the device

Press **`O`** to open the **Deploy Omega** wizard (downloads Omega + SQLite deps from CDN, scaffolds replication). → [Omega deploy](/tools/platform-tui/omega-deploy)

## Event stream

Connects to `GET /projects/{id}/events/stream` with 24h replay on connect. Events appear as:

```
[HH:MM:SS.mmm] domain.entity.action  outcome  message
```

Press `r` to reconnect; `↑/↓` to scroll history.

## Data explorer

Posts **QueryScript v2** JSON to `POST /projects/{id}/queryscript`.

* Edit JSON in the textarea
* `Ctrl+Enter` to run
* Browse tabular results in scrollable viewport
* `e` edit · `r` re-run

## Edge sync

Governance UI for SQLite replication:

1. **Lineages** — active sync pipelines from edge devices
2. Select lineage → schema fingerprints
3. **`d`** — staged payloads · **`w`** — written/materialized rows
4. **`s`** / **`w`** toggle on data screen
5. **Schema reviews** — claim, approve, or reject schema changes

Written data reads the relational mirror when provisioned; otherwise defaults to QueryScript against telemetry tables.

→ Full guide: [Edge SQLite sync](/edge/data-sync/overview) · [golain Edge Sync](/edge/data-sync/platform-tui-guide)

## Screenshots

The ilyama repo includes generated TUI screenshots under `tools/platform-tui/test/screenshots/` for regression testing — useful as visual reference when writing internal runbooks.