# Pandora — CLI Toolkit with TUI Popups
Pandora provides interactive TUI popups for use in scripts and terminal workflows.
## Usage
```
pan [OPTIONS] <COMMAND>
```
## Options
| `--guide` | Show this guide |
## Subcommands
| `confirm` | Confirmation popup (y/n). Returns 0 or 1. |
| `choose` | Interactive item selector. |
| `filter` | Filter & select popup with text input. |
| `spin` | Animated spinner with optional command execution. |
| `log` | Print a formatted, colored log line. |
| `input` | Capture text input from the user. |
| `file` | Interactive file browser for selecting files. |
| `menu` | Interactive tree menu from JSON stdin. |
| `update` | Self-update pandora to the latest version. |
Run `pan <subcommand> --guide` for basic usage, flags, and keybindings.
## Documentacion avanzada
Para patrones de scripting, recetas completas, uso de badges, y referencias
detalladas de todos los subcomandos, consulta la documentacion externa:
- **Skill usar-pandora**: recetas, patrones, guias detalladas
- **Recetas (`recetas.md`)**: 28 patrones comprobados (menus, wizards, badges, etc.)
- **Referencia (`subcomandos.md`)**: cheatsheet de todos los comandos
Accede via `pan --guide` para ayuda rapida, o revisa los archivos en
`docs/skills/use-pandora-kit/` para la documentacion completa.