Terminal UI (TUI)
Terminal UI (TUI)
Section titled “Terminal UI (TUI)”kazma-tuiBuilt with Textual (kazma-tui). Provides a dashboard for chat, status, files/editor, and HITL prompts without a browser.
Capabilities
Section titled “Capabilities”| Area | Notes |
|---|---|
| Chat | Talk to the same agent brain as Web/gateway |
| Editor / files | IDE-style workspace operations via shared IdeService / tools |
| Documents | Documents tab (DocumentsPanel) — list/inspect processed docs through the running server’s Documents API (upload still Web/chat) |
| HITL | Approval modal widgets for danger tools |
| Status | Models, gateway, health |
| Language | English or Arabic: Ctrl+L, or Ctrl+P → Switch language; the choice is saved. The tabs and the navigation rail follow it in the web UI’s words, with right-to-left styling for Arabic |
| Demo mode | KAZMA_DEMO_MODE (never use in real prod) |
Documents tab
Section titled “Documents tab”- Nav rail entry Documents (keyboard 8).
- Reads the running server (
kazma serve) throughGET /api/documents; with no server it says the platform is unavailable. The server applies the same ACL as on the Web page to the TUI’s credential (the shared secret header, so theoperatorprincipal;localwhen no secret is configured), so it lists the documents that principal can read. Refresh reloads the list. - Select a row to preview the first 8,000 characters of its fenced content
(
GET /api/documents/{document_id}/content); a document that is notreadyyet shows “Preview failed”. - Upload / convert / GC remain on Web
/documentsor agent tools — TUI is inspect-first.
Guide: Document Intelligence.
Config
Section titled “Config”Respects the same kazma.yaml, ConfigStore, and env vars as the Web UI (KAZMA_SECRET when talking to a remote server, vector memory envs, etc.).