tui-development

Document architecture and workflows for building the OpenShell TUI.

8.1k|1.2k|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/NVIDIA/OpenShell --skill tui-development-nvidia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tui-development
Source: https://github.com/NVIDIA/OpenShell/tree/main/.agents/skills/tui-development
Command: npx skills add https://github.com/NVIDIA/OpenShell --skill tui-development-nvidia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenShell TUI development projects require a clear, shared guide to architecture, navigation patterns, theming, and workflow. This skill provides a centralized reference for building, testing, and extending the TUI component set.

Core Features & Use Cases

  • Roadmap-style architecture overview covering gateway-sandboxes-logs hierarchy, theming, and UX conventions.
  • Reusable UI components and interaction patterns for dashboards, detail views, and log viewers.
  • Use Case: A developer adds a new screen to the TUI and follows consistent patterns for navigation, keyboard shortcuts, and styling.

Quick Start

Install dependencies and run the TUI locally with mise run term to explore the dashboard.

Frequently Asked Questions about tui-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and extend a ratatui-based terminal UI in Rust?

Building a ratatui-based terminal UI in Rust requires following a centralized guide covering architecture, module layout, and UX workflows to ensure consistent navigation, theming, and keyboard shortcuts across dashboard components.

What is the recommended architecture for a Rust TUI with dashboard and logs components?

The recommended Rust TUI architecture follows a roadmap-style hierarchy connecting gateway, sandboxes, and logs, applying reusable UI components and interaction patterns for dashboards, detail views, and log viewers.

How do I add a new screen to a ratatui terminal application?

To add a new screen to a ratatui terminal application, apply consistent patterns for navigation, keyboard shortcuts, and styling defined by the project's reusable UI component set and UX conventions.

How do I run a Rust TUI locally to test dashboard and detail views?

To run a Rust TUI locally, install dependencies and execute the command `mise run term` to explore the dashboard, detail views, and log viewers in the development environment.

Do I need prior Rust experience to develop terminal UI components with ratatui?

Developing terminal UI components with ratatui requires intermediate implementation depth, meaning contributors need foundational Rust knowledge to handle module layout, theming, and data fetching workflows effectively.