pandora-kit 0.3.0

Interactive TUI toolkit for the Hefesto framework
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

# pandora file — File Browser

Opens an interactive file browser popup to select a file.

## Usage

```
pandora file [OPTIONS] [PATH]
```

## Arguments

| Argument | Default       | Description                        |
|----------|---------------|------------------------------------|
| `PATH`   | Current dir   | Starting directory                 |

## Options

| Flag                     | Default              | Description                        |
|--------------------------|----------------------|------------------------------------|
| `-d`, `--dirs`           | (off)                | Select directories mode            |
| `-m`, `--multi`          | (off)                | Enable multi-select with Space     |
| `-M`, `--max`            | (unlimited)          | Max selected items                 |
| `-W`, `--width`          | `0` (auto)           | Popup width                        |
| `--guide`                |                      | Show this guide                    |

## Selection behavior

| Modo | Enter | Space | `o` en directorio |
|---|---|---|---|
| (sin flags) | archivo → selecciona, directorio → entra | — | Entra al directorio |
| `--dirs` | Selecciona directorio actual (cwd) | Selecciona el directorio y termina | Entra al directorio |
| `--multi` | Confirma los toggled | Toggle archivos | Entra al directorio |
| `--multi --dirs` | Confirma los toggled | Toggle directorios | Entra al directorio |

## Exit codes

| Code | Meaning                     |
|------|-----------------------------|
| 0    | File(s) selected (path on stdout) |
| 1    | Cancelled / invalid selection  |

## Examples

```bash
# Browse from current directory
pandora file

# Select a file from a specific path
pandora file /home/user/Documents

# Select current directory (Enter) or a subdirectory (Space)
pandora file -d

# Multi-select files
pandora file -m
```

## Keys

| Key              | Action                        |
|------------------|-------------------------------|
| `↑` / `k`        | Navigate up                   |
| `↓` / `j`        | Navigate down                 |
| `g` `g`          | Go to first item              |
| `G`              | Go to last item               |
| `o`              | Enter directory               |
| `Space`          | Select dir (dirs) / Toggle files (multi) / Toggle dirs (multi --dirs) |
| `Enter`          | Select / confirm              |
| `←` / `Backspace`| Go to parent directory        |
| `/`              | Filter list                   |
| `Esc`            | Exit / close filter           |
| `Ctrl` + `c`     | Emergency exit                |