textual-cli

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

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

# 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.