vibe-action 0.0.3

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
63
64
65
66
67
68
69
70
71

# 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_LOG_TYPE`    | Output mode: `cli`, `plain`, `json`, `tracing`           | `cli`                        |
| `VIBE_TRACE_LEVEL` | Tracing level: `error`, `warn`, `info`, `debug`, `trace` | `info`                       |

## Output Modes

| Mode      | Description                                    |
| --------- | ---------------------------------------------- |
| `cli`     | ANSI colors, progress bar, framed results      |
| `plain`   | Result only, no formatting (for tests/CI)      |
| `json`    | JSON objects `{"level":"...","message":"..."}` |
| `tracing` | Structured logs with timestamps and log levels |

## Trace Levels

| Level   | Description               |
| ------- | ------------------------- |
| `error` | Errors only               |
| `warn`  | Warnings and errors       |
| `info`  | Flow progress and results |
| `debug` | Detailed engine internals |
| `trace` | Maximum verbosity         |

## 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 tone   # reads from clipboard
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_LOG_TYPE=tracing VIBE_TRACE_LEVEL=debug` for detailed logs:

```bash
VIBE_LOG_TYPE=tracing VIBE_TRACE_LEVEL=debug vibe-action commit -p .
```

Shows:

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