# Pandora — CLI Toolkit with TUI Popups

Pandora provides interactive TUI popups for use in scripts and terminal workflows.

## Usage

```
pan [OPTIONS] <COMMAND>
```

## Options

| Flag        | Description                     |
|-------------|---------------------------------|
| `--guide`   | Show this guide                 |

## Subcommands

| Command       | Description                                        |
|---------------|----------------------------------------------------|
| `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.             |

Run `pan <subcommand> --guide` for detailed documentation of each command.
