Skip to main content
skill CX Codex

tui-fundamentals — Claude Code skill: what it does, how to install

The tui-fundamentals skill helps plan a terminal UI, pick a framework, and review its architecture. Use it for dashboards, REPLs, wizards, and interactive CLI flows.

MIT 369 installs ★ 66 updated 2026-06-18

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a claude-code
Open on GitHub

What tui-fundamentals does

tui-fundamentals helps decide whether a terminal product needs a full-screen interface or should stay with commands, prompts, or plain output. It covers full-screen, inline, prompt-based, and hybrid designs, along with keyboard navigation, help access, and non-interactive alternatives for core actions.

The skill separates model, update, and view responsibilities, treats terminal dimensions as input, and keeps terminal lifecycle handling in one place. Its framework matrix covers Ratatui, Textual, Rich, prompt_toolkit, curses, Bubble Tea, Ink, and other options. Two reference files cover framework selection and TUI architecture in more detail.

It also addresses TERM=dumb, non-TTY output, CI, SSH, tmux/screen, and Windows console differences. For a short, scriptable workflow, the skill treats a full-screen TUI as the wrong direction, so the project should define a non-interactive path for each essential action.

What it helps with

  • choose the right terminal UI shape
  • compare TUI frameworks for a new project
  • separate application state from rendering
  • plan layout changes on terminal resize
  • keep interactive features usable in CI and SSH

Example prompts for the agent

  • Design a terminal dashboard and decide between a full-screen and inline UI.
  • Compare Ratatui + Crossterm, Textual, and curses for this new TUI project.
  • Review this interactive CLI architecture for state, resize handling, and non-TTY behavior.

How to install tui-fundamentals

1Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a claude-code

2Manually: put the files in place

~/.claude/skills/tui-fundamentals/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tui-fundamentals/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tui-fundamentals

How do I install tui-fundamentals in Claude Code?

Run npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a claude-code, then check ~/.claude/skills/tui-fundamentals/SKILL.md.

What does tui-fundamentals do?

It guides terminal UI decisions, framework selection, state architecture, and production-readiness checks. It also covers keyboard-first interaction and fallback behavior.

When should a CLI use plain output instead of a TUI?

For short, scriptable, automation-focused flows, or workflows used with screen readers and CI, the skill favors a line-oriented CLI, prompts, or plain output.

Source text

SKILL.md · MIT
---
name: tui-fundamentals
description: |
  This skill should be used when the user asks to design, create, choose, modernize, or review a terminal UI, text user interface, curses app, dashboard, wizard, REPL shell, prompt flow, or CLI with interactive screens. PROACTIVELY activate for: TUI architecture, terminal-ui design, framework selection, curses vs modern framework, full-screen vs inline UI, app state modeling, widget composition, command palette, keyboard-first workflow, terminal dashboard, interactive CLI UX, and cross-platform terminal product planning. Provides: architecture patterns, framework decision rules, UX guardrails, scope boundaries, and production readiness checklists.
---

# TUI Fundamentals, Architecture, and Framework Selection

Use this skill when the task is about the shape of the terminal product: what kind of TUI to build, which abstraction to use, how to organize state, or whether a full-screen terminal UI is the right answer.

## First decision: is a TUI appropriate?

Prefer a rich TUI when users need continuous visual feedback, multi-step navigation, keyboard-driven exploration, selection among many items, or a dashboard-like control surface. Prefer a line-oriented CLI, prompts, or plain output when the flow is short, scriptable, primarily automation-focused, or likely to be used by screen readers and CI systems.

A production terminal product often ships both:

- A scriptable CLI surface for automation, accessibility, logs, and non-TTY use.
- An optional TUI for exploration, monitoring, bulk selection, or guided workflows.

## Architecture rules

1. **Separate model, update, and view.** Business state should not print directly to the terminal. Rendering consumes state; input produces events; update logic transforms state.
2. **Treat terminal size as input.** Layout must be recomputed from width and height on every resize. Never bake in one terminal size.
3. **Own terminal lifecycle in one place.** Raw mode, alternate screen, mouse, focus, keyboard protocols, and cleanup should be centralized.
4. **Make every action keyboard-operable.** Mouse support is an enhancement, not the primary navigation model.
5. **Design for degradation.** `TERM=dumb`, non-TTY output, missing color, Windows console differences, tmux/screen, SSH, and CI should have clear behavior.
6. **Avoid hidden global terminal writes.** Logs, progress, and background task output must not corrupt the screen.

## Framework selection quick matrix

| Need | Strong default |
|--|--|
| Rust full-screen app with precise rendering | Ratatui + Crossterm |
| Python product-grade app with widgets, CSS, async workers | Textual |
| Python rich output, progress, tables, markdown, logs | Rich |
| Python REPL, shell, completions, complex prompt input | prompt_toolkit |
| Classic dependency-light Unix TUI | curses/ncurses |
| Go Elm-style app with composable commands | Bubble Tea + Bubbles + Lip Gloss |
| Go batteries-included forms/tables/tree views | tview over tcell |
| Go portable low-level cell engine | tcell |
| React-style terminal components in Node | Ink |
| Node DOM-like full-screen widgets | Blessed |
| .NET full-screen views | Terminal.Gui |
| .NET rich CLI output and prompts | Spectre.Console |

Read `references/framework-selection.md` before committing to a framework in a new project.

## Product design checklist

- Define the primary user journey in one sentence.
- Decide whether the app is full-screen, inline, prompt-based, or hybrid.
- List required environments: Windows Terminal, classic conhost, macOS Terminal, iTerm2, GNOME Terminal, Alacritty, SSH, tmux/screen, CI, and logs.
- Define minimum terminal dimensions and the small-screen fallback.
- Define exit keys, destructive confirmation rules, and recovery instructions.
- Define non-interactive equivalents for every essential action.
- Decide how help is exposed: footer hints, `?`, command palette, `--help`, docs.

## Failure modes

- Building a full-screen UI for a workflow that should be scriptable.
- Choosing a low-level escape-sequence approach when a framework already solves layout, input, cleanup, and testing.
- Mixing business logic with terminal writes, making tests brittle and rendering inconsistent.
- Ignoring screen-reader users, CI, pipes, and `TERM=dumb` until late.
- Assuming color, Unicode icons, Nerd Fonts, or mouse support are always available.

## Reference files

- `references/framework-selection.md` - Detailed ecosystem comparison and decision tree.
- `references/tui-architecture.md` - State, event, lifecycle, logging, and distribution patterns.

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Similar skills

All skills for Frontend and UI →

From the same set96

The whole set →
tailwindcss-responsive-darkmode tailwindcss-responsive-darkmode — a Tailwind CSS skill covering responsive layout, dark mode, runtime theme switching and FOUC prevention. CX Codex +1 480installs bash-master bash-master guides bash scripting with ShellCheck linting, error-trapping preambles, and cross-platform handling for Linux, macOS, WSL, and containers. CX Codex +1 464installs context-master context-master — a planning skill for complex tasks and multi-file projects. It makes the agent lay out a plan before writing any files. CX Codex +1 401installs tailwindcss-fundamentals-v4 tailwindcss-fundamentals-v4 — a skill covering Tailwind CSS v4: install steps, CSS-first config with @theme, v3-to-v4 migration and the new utilities. Useful when a project moves to v4. CX Codex +1 398installs tailwindcss-accessibility tailwindcss-accessibility is a Claude Code skill for building accessible interfaces with Tailwind CSS. It activates for WCAG work, focus styling, contrast, and ARIA patterns. CX Codex +1 302installs tailwindcss-framework-integration tailwindcss-framework-integration guides Tailwind CSS setup across React, Vite, Next.js, Vue, Nuxt, and SvelteKit. Useful for configuring bundler plugins, dark mode, and framework class merging. CX Codex +1 298installs ffmpeg-color-grading-chromakey ffmpeg-color-grading-chromakey is a Claude Code skill with FFmpeg filters for green screen removal, LUT application, and video color correction in AI-assisted editing. CX Codex +1 284installs tailwindcss-advanced-components The tailwindcss-advanced-components skill covers Tailwind CSS component variants with CVA, compound variants, and cn. Use it when building reusable React components in shadcn/ui-style projects. CX Codex +1 253installs

Project sponsors

Companies that keep this analytics open