Reusable patterns for building Norton Commander / Gopher style TUI wizards with Python Rich. Covers architecture, components, keyboard input, bilingual i18n, ListSelector, and 21 battle-tested gotchas. Reference implementation: DTM Agent TUI (dintel-gtm-agent/src/dtm/tui/) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
29 lines
932 B
Markdown
29 lines
932 B
Markdown
# 93-tui-designer
|
|
|
|
Build Norton Commander / Gopher style TUI wizard interfaces for any Python CLI tool using Rich.
|
|
|
|
## Purpose
|
|
|
|
Reusable patterns and battle-tested gotchas for building retro-style terminal wizards with:
|
|
- Dual-panel layout (status + content)
|
|
- Stack-based Gopher navigation (numbered menus, Back, Home)
|
|
- Arrow-key list selector for long option lists
|
|
- Bilingual i18n with runtime toggle
|
|
- Keyboard-driven input (F-keys with alphanumeric fallbacks)
|
|
- Three-tier responsive layout (wide/narrow/single panel)
|
|
|
|
## Structure
|
|
|
|
```
|
|
93-tui-designer/
|
|
code/SKILL.md # Main skill (architecture, patterns, gotchas)
|
|
shared/references/
|
|
dtm-wizard-reference.md # DTM Agent implementation reference
|
|
docs/ # Future: logs, lessons learned
|
|
```
|
|
|
|
## First Implementation
|
|
|
|
DTM Agent TUI Wizard — 20 files, 21 screens, 29 tests.
|
|
See `shared/references/dtm-wizard-reference.md` for details.
|