Perfect for Terminal UI Automation Agents needing streamlined workflows with decision trees and framework references. OpenTUI is a terminal UI automation tool for coding agents, helping developers streamline workflows with decision trees and framework references. It supports agents like Claude Code, Cursor, and Windsurf.

如何安装 opentui？

运行命令：npx killer-skills add nitodeco/ralph/opentui。支持 Cursor、Windsurf、VS Code、Claude Code 等 19+ IDE/Agent。

opentui 适用于哪些场景？

典型场景包括：Automating terminal UI workflows、Generating framework references for React and Solid、Debugging terminal UI applications with OpenTUI's gotchas guide。

opentui 支持哪些 IDE 或 Agent？

该技能兼容 Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer。可使用 Killer-Skills CLI 一条命令通用安装。

opentui 有哪些限制？

Requires Bun and Zig for native builds；Must follow specific critical rules, such as using `create-tui` for new projects and avoiding direct calls to `process.exit()`。

opentui

安装 opentui，这是一款面向AI agent workflows and automation的 AI Agent Skill。查看评审结论、使用场景与安装路径。

SKILL.md

Readonly

Upstream Repository Material

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

Supporting Evidence

OpenTUI Platform Skill

Name: opentui
Availability: InStock
Author: nitodeco

Consolidated skill for building terminal user interfaces with OpenTUI. Use decision trees below to find the right framework and components, then load detailed references.

Critical Rules

Follow these rules in all OpenTUI code:

Use create-tui for new projects. See framework REFERENCE.md quick starts.
create-tui options must come before arguments. bunx create-tui -t react my-app works, bunx create-tui my-app -t react does NOT.
Never call process.exit() directly. Use renderer.destroy() (see core/gotchas.md).
Text styling requires nested tags in React/Solid. Use modifier elements, not props (see components/text-display.md).

How to Use This Skill

Reference File Structure

Framework references follow a 5-file pattern. Cross-cutting concepts are single-file guides.

Each framework in ./references/<framework>/ contains:

File	Purpose	When to Read
`REFERENCE.md`	Overview, when to use, quick start	Always read first
`api.md`	Runtime API, components, hooks	Writing code
`configuration.md`	Setup, tsconfig, bundling	Configuring a project
`patterns.md`	Common patterns, best practices	Implementation guidance
`gotchas.md`	Pitfalls, limitations, debugging	Troubleshooting

Cross-cutting concepts in ./references/<concept>/ have REFERENCE.md as the entry point.

Reading Order

Start with REFERENCE.md for your chosen framework
Then read additional files relevant to your task:
- Building components -> api.md + components/<category>.md
- Setting up project -> configuration.md
- Layout/positioning -> layout/REFERENCE.md
- Keyboard/input handling -> keyboard/REFERENCE.md
- Animations -> animation/REFERENCE.md
- Troubleshooting -> gotchas.md + testing/REFERENCE.md

Example Paths

./references/react/REFERENCE.md           # Start here for React
./references/react/api.md              # React components and hooks
./references/solid/configuration.md    # Solid project setup
./references/components/inputs.md      # Input, Textarea, Select docs
./references/core/gotchas.md           # Core debugging tips

Runtime Notes

OpenTUI runs on Bun and uses Zig for native builds. Read ./references/core/gotchas.md for runtime requirements and build guidance.

Quick Decision Trees

"Which framework should I use?"

Which framework?
├─ I want full control, maximum performance, no framework overhead
│  └─ core/ (imperative API)
├─ I know React, want familiar component patterns
│  └─ react/ (React reconciler)
├─ I want fine-grained reactivity, optimal re-renders
│  └─ solid/ (Solid reconciler)
└─ I'm building a library/framework on top of OpenTUI
   └─ core/ (imperative API)

"I need to display content"

Display content?
├─ Plain or styled text -> components/text-display.md
├─ Container with borders/background -> components/containers.md
├─ Scrollable content area -> components/containers.md (scrollbox)
├─ ASCII art banner/title -> components/text-display.md (ascii-font)
├─ Code with syntax highlighting -> components/code-diff.md
├─ Diff viewer (unified/split) -> components/code-diff.md
├─ Line numbers with diagnostics -> components/code-diff.md
└─ Markdown content (streaming) -> components/code-diff.md (markdown)

"I need user input"

User input?
├─ Single-line text field -> components/inputs.md (input)
├─ Multi-line text editor -> components/inputs.md (textarea)
├─ Select from a list (vertical) -> components/inputs.md (select)
├─ Tab-based selection (horizontal) -> components/inputs.md (tab-select)
└─ Custom keyboard shortcuts -> keyboard/REFERENCE.md

"I need layout/positioning"

Layout?
├─ Flexbox-style layouts (row, column, wrap) -> layout/REFERENCE.md
├─ Absolute positioning -> layout/patterns.md
├─ Responsive to terminal size -> layout/patterns.md
├─ Centering content -> layout/patterns.md
└─ Complex nested layouts -> layout/patterns.md

"I need animations"

Animations?
├─ Timeline-based animations -> animation/REFERENCE.md
├─ Easing functions -> animation/REFERENCE.md
├─ Property transitions -> animation/REFERENCE.md
└─ Looping animations -> animation/REFERENCE.md

"I need to handle input"

Input handling?
├─ Keyboard events (keypress, release) -> keyboard/REFERENCE.md
├─ Focus management -> keyboard/REFERENCE.md
├─ Paste events -> keyboard/REFERENCE.md
├─ Mouse events -> components/containers.md
└─ Text selection -> components/text-display.md

"I need to test my TUI"

Testing?
├─ Snapshot testing -> testing/REFERENCE.md
├─ Interaction testing -> testing/REFERENCE.md
├─ Test renderer setup -> testing/REFERENCE.md
└─ Debugging tests -> testing/REFERENCE.md

"I need to debug/troubleshoot"

Troubleshooting?
├─ Runtime errors, crashes -> <framework>/gotchas.md
├─ Layout issues -> layout/REFERENCE.md + layout/patterns.md
├─ Input/focus issues -> keyboard/REFERENCE.md
└─ Repro + regression tests -> testing/REFERENCE.md

Troubleshooting Index

Terminal cleanup, crashes -> core/gotchas.md
Text styling not applying -> components/text-display.md
Input focus/shortcuts -> keyboard/REFERENCE.md
Layout misalignment -> layout/REFERENCE.md
Flaky snapshots -> testing/REFERENCE.md

For component naming differences and text modifiers, see components/REFERENCE.md.

Product Index

Frameworks

Framework	Entry File	Description
Core	`./references/core/REFERENCE.md`	Imperative API, all primitives
React	`./references/react/REFERENCE.md`	React reconciler for declarative TUI
Solid	`./references/solid/REFERENCE.md`	SolidJS reconciler for declarative TUI

Cross-Cutting Concepts

Concept	Entry File	Description
Layout	`./references/layout/REFERENCE.md`	Yoga/Flexbox layout system
Components	`./references/components/REFERENCE.md`	Component reference by category
Keyboard	`./references/keyboard/REFERENCE.md`	Keyboard input handling
Animation	`./references/animation/REFERENCE.md`	Timeline-based animations
Testing	`./references/testing/REFERENCE.md`	Test renderer and snapshots

Component Categories

Category	Entry File	Components
Text & Display	`./references/components/text-display.md`	text, ascii-font, styled text
Containers	`./references/components/containers.md`	box, scrollbox, borders
Inputs	`./references/components/inputs.md`	input, textarea, select, tab-select
Code & Diff	`./references/components/code-diff.md`	code, line-number, diff, markdown

Resources

Repository: https://github.com/anomalyco/opentui Core Docs: https://github.com/anomalyco/opentui/tree/main/packages/core/docs Examples: https://github.com/anomalyco/opentui/tree/main/packages/core/src/examples Awesome List: https://github.com/msmps/awesome-opentui

opentui — for Claude Code opentui, community, for Claude Code, ide skills, terminal UI automation, OpenTUI platform, decision tree workflow, framework reference management, React and Solid support, long-running coding agents

关于此技能

功能特性

# 核心主题

Killer-Skills Review

核心价值

适用 Agent 类型

↓ 赋予的主要能力 · opentui

! 使用限制与门槛

Why this page is reference-only

Source Boundary

先决定动作，再继续看上游仓库材料

先进入安装与验证

回到可信合集再做一次复核

如果要进团队流转，转到工作流集合

Browser Sandbox Environment

⚡️ Ready to unleash?

常见问题与安装步骤

? FAQ

opentui 是什么？