add TUI

tui/README.md

@@ -0,0 +1,48 @@
+# Sybil TUI
+
+Terminal UI client for Sybil with a sidebar + workspace flow similar to the web app.
+
+## Setup
+
+```bash
+cd tui
+npm install
+npm run dev
+```
+
+Build/start:
+
+```bash
+npm run build
+npm run start
+```
+
+## Environment Variables
+
+Configuration is environment-only (no in-app settings).
+
+- `SYBIL_TUI_API_BASE_URL`: API base URL. Default: `http://127.0.0.1:8787`
+- `SYBIL_TUI_ADMIN_TOKEN`: optional bearer token for token-mode servers
+- `SYBIL_TUI_DEFAULT_PROVIDER`: `openai` | `anthropic` | `xai` (default: `openai`)
+- `SYBIL_TUI_DEFAULT_MODEL`: optional default model name
+- `SYBIL_TUI_SEARCH_NUM_RESULTS`: results per search run (default: `10`)
+
+Compatibility aliases:
+
+- `SYBIL_API_BASE_URL` (fallback for API URL)
+- `SYBIL_ADMIN_TOKEN` (fallback for token)
+
+## Key Bindings
+
+- `Tab` / `Shift+Tab`: move focus between sidebar, transcript, and composer
+- `Esc` (in composer): exit input mode and focus sidebar
+- `Up` / `Down` (in sidebar): move highlight
+- `Enter` in sidebar: load highlighted conversation/search
+- `Enter` in composer: send message/search
+- `n`: new chat draft
+- `/`: new search draft
+- `d`: delete selected chat/search
+- `p`: cycle provider (chat mode)
+- `m`: cycle model (chat mode)
+- `r`: refresh collections + models
+- `q` or `Ctrl+C`: quit