Gentleman-Programming/gentle-shell / skills/tui-design
gentle-ai-tui-design
VerifiedTrigger: terminal UI design, TUI redesign, Gentle Shell look, IDE in a terminal, sidebar/status bar polish, critique TUI. Refine terminal UIs with visual proof.
| File | Kind | Size |
|---|---|---|
| NOTICE.md | markdown | 403 B |
| SKILL.md | skill md | 3.3 KB |
| references/commands.md | markdown | 3.1 KB |
| references/critique.md | markdown | 2.1 KB |
| references/design-doc.md | markdown | 1.4 KB |
| references/terminal-craft.md | markdown | 3.9 KB |
| references/visual-loop.md | markdown | 1.8 KB |
references/visual-loop.md
View on GitHub# Visual Loop (eyes)
## Gentle Shell harness
From a Gentle Shell checkout that has `scripts/shell-snapshot.mjs`:
```bash
node scripts/shell-snapshot.mjs --latest-rich # newest session with todos and subagents
node scripts/shell-snapshot.mjs --session <file.jsonl> --cols 180 --rows 50
node scripts/shell-snapshot.mjs --latest-rich --cols 139 --rows 40 # just below the rail breakpoint
node scripts/shell-snapshot.mjs --latest-rich --cols 80 --rows 24 # narrow
```
- It forks the session into a `/tmp/gentle-eyes.*` scratch dir (`--fork --session-dir`), so the source session is never written.
- It launches the checkout's own `bin/gentle-shell.mjs` in fullscreen under ttyd and headless Chrome, and prints PNG paths; read them with the image-capable read tool.
- It strips inherited agent variables (`PI_*`, `GENTLE_PI_*`, `GENTLE_SHELL_*`, `HERDR_*`); without that a shell launched from an agent acts as a child and never mounts the rail.
- Never type prompts into the captured shell: it inherits the user's permission mode.
- Remove the scratch dirs it reports when done.
vhs 0.12.0 produced no output on this machine; prefer the harness.
## Loop
1. Capture "before" at the sizes that matter; name files by size and step.
2. Write the critique or brief before editing.
3. Edit, re-capture, read both PNGs, and compare against the brief point by point.
4. Stop after 3 rounds or when no P0-P2 remains; report what is left.
5. Pair visual checks with the repo's focused render tests (render counts, overflow, breakpoints).
## Mockups first
For redesigns, draw directions with `gentle-design` before code. Constrain artboards to the terminal: a fixed monospace grid in `ch` units at the real column count, theme colors only, no font sizes or radii, glyphs from the DESIGN.md family. Then match the implementation screenshot to the chosen artboard.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |