Initial commit: hqt — HQ Terminal TUI
TUI for orchestrating AI coding harness sessions (Claude Code, Codex, Kiro, etc.) via tmux. Click CLI bootstraps a Textual TUI over ProjectService/SessionService backed by SQLite, spawning harness sessions as tmux windows through TmuxManager. Includes recent fixes: - Visible Tab focus highlight on dialog OK/Cancel buttons - Auto-select first project on launch - Auto-select first session + per-project session-selection memory - tmux new-window targets an explicit free index, fixing "index N in use" failures (broken spawn/attach in attached sessions) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,37 @@
|
||||
# hqt — HQ Terminal
|
||||
|
||||
A TUI for orchestrating AI coding harness sessions (Claude Code, Kiro, Aider, etc.) via tmux.
|
||||
Manage multiple AI sessions across projects from a single terminal interface.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
uv pip install -e .
|
||||
hqt
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `hqt` | Launch the TUI (inside tmux) |
|
||||
| `hqt doctor` | Check system requirements |
|
||||
| `hqt list` | List projects and sessions |
|
||||
|
||||
## Key Bindings
|
||||
|
||||
| Key | Action |
|
||||
|-----|--------|
|
||||
| `q` | Quit |
|
||||
| `n` | New session |
|
||||
| `a` | Add project |
|
||||
| `e` | Edit project |
|
||||
| `Tab` | Switch panel |
|
||||
| `d` | Delete session |
|
||||
| `Enter` | Attach to session (auto-resumes if not running) |
|
||||
| `r` | Rename session |
|
||||
| `s` | Stop session |
|
||||
|
||||
## Architecture
|
||||
|
||||
hqt uses a layered architecture: a Click CLI bootstraps into a Textual TUI, which drives service classes (ProjectService, SessionService) backed by SQLite via SQLAlchemy. Sessions are spawned as tmux windows through TmuxManager, with harness-specific configuration provided by pluggable HarnessConfigurator implementations discovered at runtime.
|
||||
Reference in New Issue
Block a user