vibe-action 0.2.1

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

# IDE Integration (VS Code & IntelliJ)

Vibe Action works perfectly from the terminal, but you can supercharge your workflow with the **Vibe Action Cross** IDE plugin.

Instead of manually configuring `tasks.json` in VS Code or `External Tools` in IntelliJ, the plugin provides a native UI panel inside your editor. It communicates directly with the `vibe-action` CLI to discover all available actions, letting you run them with visible, real-time feedback.

## Why Use the Plugin?

- **Zero Configuration:** No need to edit JSON/XML files. The plugin automatically fetches all available actions from the `vibe-action` CLI — including built-in commands, your custom YAML flows, and any modifications you've made to the defaults.
- **Context Awareness:** Automatically passes selected text, file paths, or project context to your actions using the unified `{query}` tag.
- **Native UI:** Get real-time progress feedback inside the IDE instead of waiting for terminal windows or system notifications.
- **Seamless Output:** Results can automatically replace selected code, be copied to the clipboard, or appear in a native dialog window.

## Prerequisites

1. **Vibe Action CLI** must be installed and available on your system `PATH`.
   ```bash
   cargo install vibe-action
   ```
2. Get the plugin: Download the latest pre-built artifacts (`.vsix` and `.zip`) directly from the [dist directory on GitCode](https://gitcode.com/keygenqt_vz/vibe-action-cross/tree/main/dist), or build them yourself from the [vibe-action-cross](https://gitcode.com/keygenqt_vz/vibe-action-cross) repository source.

## VS Code Setup

1. Open VS Code.
2. Go to the Extensions view (`Cmd+Shift+X` or `Ctrl+Shift+X`).
3. Click the `...` menu in the top-right corner of the Extensions panel.
4. Select **Install from VSIX...**.
5. Navigate to the downloaded file and select `vibe-action-0.0.1.vsix`.
6. Reload VS Code when prompted.

_Alternatively, install via CLI:_

```bash
code --install-extension vibe-action-0.0.1.vsix
```

Once installed, open the Vibe Action panel from the activity bar. You will see a list of all your available actions. Click any action to run it, or use the provided keyboard shortcuts.

## IntelliJ IDEA Setup

1. Open IntelliJ IDEA.
2. Go to `Settings/Preferences` -> `Plugins`.
3. Click the gear icon (`⚙️`) in the top-right corner of the Plugins window.
4. Select **Install Plugin from Disk...**.
5. Navigate to the downloaded file and select `vibe-action-plugin-0.0.1.zip`.
6. Restart IntelliJ IDEA when prompted.

Once installed, open the Vibe Action tool window (usually located on the right sidebar). The UI is rendered natively using Compose Multiplatform and matches the IntelliJ theme.

## How It Works: The `api` Block

The `vibe-action` CLI exposes the optional `api` block from your YAML actions, which the plugin uses to determine how to handle inputs and outputs.

```yaml
name: upper
about: Convert text to UPPERCASE
api:
  output: replace # How to output: replace | clipboard | dialog
  input: query # Where to get input: query | query|file_path | query|prompt | etc.
actions:
  - tag: tag_upper
    run: value
    expect: string
    action: '{query|upper}'
```

### Output Targets (`api.output`)

- `replace`: The plugin will replace the currently selected text in your editor with the action's result.
- `clipboard`: The result will be silently copied to your system clipboard.
- `dialog`: The result will be shown in a native IDE popup/dialog.

### Input Sources (`api.input`)

The `input` field tells the plugin how to fill the `{query}` tag before executing the CLI:

- `query` (default): Passes the currently selected text (editor selection) to `{query}`.
- `query|file_path`: Passes the path of the currently open file to `{query}`.
- `query|project_path`: Passes the root path of the open project to `{query}`.
- `query|line`: Passes the current cursor line number to `{query}`.
- `query|prompt`: Shows an interactive dialog in the IDE to ask the user for input.
- `query|image`: Passes a screenshot or selected image as base64 to `{query}`.

If an action does not have an `api` block, the plugin will simply execute it and fall back to standard CLI behavior.