docs: add TUI documentation to README

- Document TUI command and dev mode
- List all Start Screen keyboard shortcuts
- List all Main View keyboard shortcuts
- Describe key features (real-time output, tabs, attach)
- Rename existing section to "Screen Manager Script"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
arkon
2026-01-21 06:29:11 +01:00
co-authored by Claude Opus 4.5
parent 4d60cff4f3
commit 1bc9f8e7ed
+37 -2
View File
@@ -265,9 +265,44 @@ claudeman web [-p 8080] # Start web interface
claudeman status # Show overall status
```
### Screen Manager TUI
### Terminal User Interface (TUI)
Interactive terminal UI for direct screen management:
Full-featured TUI built with Ink (React for CLI):
```bash
claudeman tui # Launch TUI
npx tsx src/index.ts tui # Dev mode
```
**Start Screen:**
| Key | Action |
|-----|--------|
| `↑`/`↓` | Navigate sessions |
| `Enter` | View session in TUI |
| `a` | Attach directly to screen |
| `d` | Delete session |
| `n` | New session |
| `r` | Refresh |
| `q` | Quit |
**Main View:**
| Key | Action |
|-----|--------|
| `Ctrl+Tab` | Next session |
| `Ctrl+1-9` | Go to session N |
| `Ctrl+W` | Close session |
| `Escape` | Back to start screen |
| `?` | Show help |
Features:
- Real-time terminal output (polls screen every 500ms)
- Tab-based session navigation
- Direct screen attachment for full interactivity
- Arrow key navigation with visual selection
### Screen Manager Script
Interactive bash script for direct screen management:
```bash
./scripts/screen-manager.sh # Launch interactive mode