Vibez

A multi-agent CLI coding assistant built in Rust that uses parallel workers for faster code generation.

Features

• 🚀 Parallel Tool Execution - Independent operations run concurrently for maximum speed
• 🤖 Multi-Agent Architecture - Manager coordinates multiple worker agents
• 🔒 Smart Conflict Detection - Automatic file locking prevents race conditions
• 📝 Contract-Based Coordination - Workers share interfaces through contracts
• ⚡ Streaming Responses - Real-time output as the AI generates code
• 🎯 Topological Task Scheduling - Dependency-aware task execution

Installation

From crates.io (recommended)

cargo install vibez

From source

git clone https://github.com/taradepan/vibez
cd vibez
cargo install --path .

Setup

On first run, Vibez will prompt you for your OpenAI API key:

vibez

🔑 OpenAI API Key Required
Vibez needs your OpenAI API key to function.
Get your API key from: https://platform.openai.com/api-keys

Enter your OpenAI API key: sk-...

💾 Saving API key to ~/.vibez/config.toml...
✓ API key saved to /Users/you/.vibez/config.toml

Your API key is securely stored in ~/.vibez/config.toml and will be used for all future runs.

Usage

Interactive mode (REPL)

vibez

Single prompt mode

vibez "Add authentication to my app"

Commands

• /help - Show available commands
• /config - Show current configuration
• /clear - Clear screen
• /quit - Exit

Options

vibez --help

Configuration

Configuration Priority

Settings are loaded in this order (highest priority last):

1. Default values
2. User config file (~/.vibez/config.toml)
3. Project config file (./.vibez/config.toml)
4. Environment variables (VIBEZ_MODEL, VIBEZ_VERBOSE, VIBEZ_API_TIMEOUT)
5. CLI arguments (--model, --verbose)

Note: OpenAI API key is NOT loaded from environment variables for security. It must be in a config file.

Example Config File

~/.vibez/config.toml:

model = "gpt-5.1"
verbose = false

[api]
openai_api_key = "sk-..."
timeout = 60

Architecture

Vibez uses a sophisticated multi-agent architecture:

1. Manager Agent - Plans tasks, creates contracts, and coordinates workers
2. Worker Agents - Execute tasks in parallel with contract adherence
3. Tool Registry - Provides file operations, bash commands, and more
4. File Locking - Prevents conflicts when multiple workers access the same files
5. Smart Grouping - Automatically parallelizes independent tool calls

Performance

Vibez is designed for speed:

• Parallel Tool Execution: Independent file reads/writes run concurrently
• Conflict Detection: Graph-based algorithm groups non-conflicting operations
• Topological Scheduling: Tasks execute as soon as dependencies are met
• Rate Limiting: Semaphore-based API request management

License

MIT - see LICENSE file for details