name: textual-cli description: Textual CLI devtools for running, debugging, and exploring TUI apps. Includes run, console, serve, keys, colors, borders, easing commands. Used by tui-developer, tui-test-engineer, and tui-ux-specialist. argument-hint: "<command> [options]" allowed-tools: Bash

Textual CLI Skill

Name: textual-cli
Rating: 78
Author: mpolatcan

Not for screenshots - use /visual-analysis for capture.

Commands

Command	Purpose
`run`	Run Textual app (with optional --dev mode)
`run --press`	Navigate with simulated key presses
`console`	Debug console for print/log output
`serve`	Serve app in web browser
`keys`	Test keyboard input recognition
`colors`	Preview color system
`borders`	Preview border styles
`easing`	Preview animation easing functions

Usage

bash

# Standard run
source venv/bin/activate && textual run kubeagle/main.py

# Dev mode (live CSS editing)
source venv/bin/activate && textual run --dev kubeagle/main.py

# With charts data
source venv/bin/activate && textual run --dev kubeagle/main.py -- --charts-path ../web-helm-repository

# Navigate with key presses
source venv/bin/activate && timeout 30 textual run kubeagle/main.py --press "c,2"

Flag	Description
`--dev`	Enable dev mode (live CSS, console output)
`--press TEXT`	Comma-separated keys to simulate press

Do NOT use --screenshot flag or --press "q" (hides CSS errors). Use /visual-analysis instead.