Skip to content

Gentleman-Programming/gentle-shell / skills/tui-design

gentle-ai-tui-design

Verified

Trigger: terminal UI design, TUI redesign, Gentle Shell look, IDE in a terminal, sidebar/status bar polish, critique TUI. Refine terminal UIs with visual proof.

FileKindSize
NOTICE.mdmarkdown403 B
SKILL.mdskill md3.3 KB
references/commands.mdmarkdown3.1 KB
references/critique.mdmarkdown2.1 KB
references/design-doc.mdmarkdown1.4 KB
references/terminal-craft.mdmarkdown3.9 KB
references/visual-loop.mdmarkdown1.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.
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall