Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuration

Vibe Action uses a single YAML config file at ~/.vibe-action/config.yaml. It is created automatically on first run.

Cluster

Define one or more LLM providers. The engine sends prompts to all nodes in parallel.

version: 0.0.1

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

Cluster Node Fields

FieldTypeDescription
providerstringollama, deepseek, qwen
hoststringAPI endpoint URL
modelstringModel name
timeout_secsintegerRequest timeout in seconds
temperaturefloat0.0-2.0, lower = more deterministic
seedintegerRandom seed for reproducibility
num_ctxintegerContext window size in tokens
num_predictintegerMax tokens to generate
api_keystringAPI key for cloud providers (optional)
parallelintegerConcurrent connections (default: 1)

Multi-Node Cluster

cluster:
  - provider: ollama
    host: http://localhost:11434
    model: qwen2.5-coder:3b-instruct
    timeout_secs: 30
    temperature: 0.0
    seed: 42
    num_ctx: 4096
    num_predict: 512
    parallel: 2

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

  - provider: deepseek
    host: https://api.deepseek.com/v1
    model: deepseek-v4-flash
    timeout_secs: 120
    temperature: 0.1
    seed: 42
    num_ctx: 16384
    num_predict: 8192
    api_key: sk-...
    parallel: 2

All nodes receive prompts in parallel.

Actions Directory

Actions are stored in ~/.vibe-action/actions/. The directory is created on first run with default actions.

~/.vibe-action/
├── config.yaml
└── actions/
    ├── commit.yaml
    ├── extract.yaml
    ├── find.yaml
    ├── mock.yaml
    ├── naming.yaml
    ├── regex.yaml
    ├── spellcheck.yaml
    ├── synonyms.yaml
    ├── tone.yaml
    └── translate.yaml

Add your own .yaml files here — they will be loaded automatically.