2026-03-02 20:33:41 -08:00
|
|
|
# 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
|
2026-03-11 01:23:13 -07:00
|
|
|
- `Page Up` / `Page Down` (in transcript): scroll the transcript by one page
|
2026-03-02 20:33:41 -08:00
|
|
|
- `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
|
