From 741e4ed8b53783849ac29c556bd0707171c46938 Mon Sep 17 00:00:00 2001
From: 7000pctAUTO <lukems3823@gmail.com>
Date: Tue, 3 Feb 2026 09:41:13 +0000
Subject: [PATCH] Initial upload with CI/CD workflow

---
 app/README.md | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 112 insertions(+)
 create mode 100644 app/README.md

diff --git a/app/README.md b/app/README.md
new file mode 100644
index 0000000..31c0b08
--- /dev/null
+++ b/app/README.md
@@ -0,0 +1,112 @@
+# TUI Generator CLI
+
+A Rust CLI tool that generates beautiful, interactive terminal user interfaces for any command-line tool. It parses CLI help output and automatically creates rich TUIs with command wizards, argument autocompletion, interactive examples, and visual documentation browsers.
+
+## Features
+
+- **Automatic TUI Generation** - Parse help text from any CLI tool and generate an interactive TUI
+- **Interactive Command Wizards** - Step-by-step wizards for building complex commands with real-time validation
+- **Visual Help Browser** - Browse command documentation with syntax highlighting and navigation
+- **Custom Workflow Builders** - Define and save multi-step workflows for common tasks
+- **Config Sharing** - Export and import TUI configurations for sharing with others
+
+## Installation
+
+### From Source
+
+```bash
+cargo build --release
+```
+
+The binary will be available at `target/release/tui-generator`.
+
+### From Crates.io
+
+```bash
+cargo install tui-generator-cli
+```
+
+## Usage
+
+### Generate a TUI from a command
+
+```bash
+tui-generator generate git
+tui-generator generate kubectl
+tui-generator generate docker
+```
+
+### Launch Interactive Mode
+
+```bash
+tui-generator interactive              # Start with default commands
+tui-generator interactive --command git  # Start with specific command
+```
+
+### Export Configuration
+
+```bash
+tui-generator export git --output git.tui
+tui-generator export kubectl -o kubectl.tui
+```
+
+### List Saved Configurations
+
+```bash
+tui-generator list
+```
+
+### Run a Saved Configuration
+
+```bash
+tui-generator run git
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Tab` | Switch between tabs |
+| `Up/Down` | Navigate items |
+| `Enter` | Select/Confirm |
+| `/` | Start search |
+| `Esc` | Exit/Close |
+| `?` | Toggle help |
+| `Ctrl+C` | Quit |
+
+## Tabs
+
+1. **Commands** - View all subcommands with search functionality
+2. **Arguments** - View all available arguments in a table format
+3. **Wizard** - Build commands interactively
+4. **Help** - Documentation and keyboard shortcuts
+
+## Configuration
+
+The tool stores configuration in `~/.config/tui-generator/config.toml`.
+
+Environment variables:
+- `TUI_GEN_CONFIG_DIR` - Custom config directory path
+
+## Building
+
+```bash
+cargo build --release
+cargo test --all
+cargo clippy
+```
+
+## Dependencies
+
+- Rust 1.75+
+- Ratatui 0.30
+- Crossterm 0.29
+- Clap 4.4
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see LICENSE file for details.