vibe-action 0.2.0

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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

# Getting Started

## Prerequisites

- **Ollama** (recommended), or API keys for **DeepSeek**, **Qwen**, **Kimi**, or **Zhipu** — for LLM inference
- **Rust** (if building from source)

### Supported Platforms

- **macOS** — full support
- **Linux** — full support

### Install Ollama

```bash
# macOS / Linux
curl -fsSL https://ollama.com/install.sh | sh

# Pull models for different roles
ollama pull qwen2.5-coder:3b-instruct   # small
ollama pull qwen2.5-coder:7b-instruct   # medium
ollama pull qwen2.5-coder:14b-instruct  # large
ollama pull qwen2.5vl:7b                # vision
```

## Install Vibe Action

### Via Cargo (recommended)

```bash
cargo install vibe-action
```

### Build from source

```bash
git clone https://gitcode.com/keygenqt_vz/vibe-action.git
cd vibe-action
cargo build --release
```

## First Run

On first run, Vibe Action creates the config and default actions:

```bash
$ vibe-action --help
```

This creates:

- `~/.vibe-action/config.yaml` — configuration
- `~/.vibe-action/actions/` — 21 built-in actions

## Configure Cluster

Edit `~/.vibe-action/config.yaml` to point to your Ollama instance:

```yaml
version: '0.0.3'

action:
  system: 'You are Vibe Action — a CLI tool. Output ONLY the result.'
  retries: 2

cluster:
  - provider: ollama
    host: http://localhost:11434
    model: qwen2.5-coder:14b-instruct
    timeout_secs: 60
    temperature: 0.1
    seed: 42
    num_ctx: 4096
    num_predict: 2048
    parallel: 1
```

## Run Your First Actions

```bash
# AI-powered commit
vibe-action commit

# Translate a file
vibe-action translate-small README.md
vibe-action translate-large README.md

# Rewrite tone from clipboard
vibe-action tone

# Extract errors from logs
vibe-action extract -f app.log "find all errors"

# Describe a screenshot
vibe-action describe screenshot.png

# Fetch and summarize a web page
vibe-action fetch https://example.com

# System report
vibe-action sysinfo

# Scan project codebase as JSON
vibe-action scan

# Ask about Vibe Action itself
vibe-action faq "как использовать модификаторы?"

# Check version and status
vibe-action status

# Clear all cache
vibe-action clean

# Stop all running processes
vibe-action stop

# Run benchmarks
vibe-action bench
vibe-action bench -a faq -v

# See all available actions
vibe-action --help
```

## Debug Mode

Set `VIBE_LOG_TYPE=tracing VIBE_TRACE_LEVEL=debug` to see what's happening under the hood:

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

Shows each pipeline step: original command, resolved template, and result.

## Next Steps

- [Action Structure](./action-structure.md) — learn the YAML format
- [Query Tag](./docs/query-tag.md) — unified input for CLI and IDE
- [Built-in Actions](./built-in-actions.md) — explore what's included
- [Custom Actions](./custom-actions.md) — write your own
- [Tag System](./tag-system.md) — understand {tag} references
- [Modifiers](./modifiers.md) — transform output with pipe modifiers
- [System Tags](./system-tags.md) — built-in environment variables