vibe-action 0.0.2

Command router — execute shell commands and LLM prompts via simple YAML actions.
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

# CLI Reference

## Environment Variables

| Variable           | Description                       | Default                      |
| ------------------ | --------------------------------- | ---------------------------- |
| `VIBE_CONFIG`      | Path to config file               | `~/.vibe-action/config.yaml` |
| `VIBE_ACTION_PATH` | Path to actions directory         | `~/.vibe-action/actions/`    |
| `VIBE_DEBUG`       | Enable debug mode (`1` or `true`) | disabled                     |
| `VIBE_LOG_LEVEL`   | Tracing level (1-6)               | `4` (debug)                  |

## Log Levels

| Level | Name  | Description                |
| ----- | ----- | -------------------------- |
| 1     | error | Errors only                |
| 2     | warn  | Warnings and errors        |
| 3     | info  | Flow progress and results  |
| 4     | debug | Detailed engine internals  |
| 5     | trace | Maximum verbosity          |
| 6     | test  | Test mode (minimal output) |

## Commands

Execute a YAML-defined action directly:

```bash
vibe-action <name> [args...]
vibe-action commit -p .
vibe-action translate -f README.md -l Russian
vibe-action --help
```

## Action Arguments

Each action defines its own arguments in YAML. Use `--help` to see available options:

```bash
vibe-action commit --help
vibe-action extract --help
```

## Exit Codes

| Code | Description                                                |
| ---- | ---------------------------------------------------------- |
| 0    | Success                                                    |
| 1    | Error (validation failed, shell command failed, LLM error) |

## Debug Mode

Set `VIBE_DEBUG=1` for detailed logs of each pipeline step:

```bash
VIBE_DEBUG=1 vibe-action commit -p .
```

Shows:

- Original and resolved action text
- Shell command output
- LLM prompts and responses