voice-vibecoder 1.2.0

Olaf The Vibecoder — a voice-controlled coding assistant using OpenAI Realtime API + Claude Code

Olaf The Vibecoder

A voice-controlled coding assistant that combines OpenAI's Realtime API for voice conversation with Claude Code for autonomous coding tasks.

Quick Start

# Install and run
pip install voice-vibecoder
vibecoder

# Or run directly with uv (no install needed)
uvx voice-vibecoder

On first launch, press s to configure your OpenAI API key.

Features

• Voice conversation via OpenAI Realtime API (supports OpenAI and Azure)
• Multi-instance Claude Code agents running in separate git worktrees
• Git diff visualization with file tree and colorized hunks
• Session persistence across restarts
• Push-to-talk and voice activity detection modes
• Multi-language support (English, Norwegian, Swedish)

Requirements

• Python 3.10+
• An OpenAI API key with Realtime API access
• PortAudio for microphone input (brew install portaudio on macOS)
• Claude Code CLI installed

Usage as a Library

Embed the voice coding screen in your own Textual app:

from pathlib import Path
from voice_vibecoder import VoiceCodingApp, VoiceCodingScreen, VoiceConfig

# Standalone app with custom config
config = VoiceConfig(
    app_name="My Coding Assistant",
    config_dir=Path.home() / ".my-app",
    data_dir=Path.home() / ".my-app",
    log_dir=Path.home() / ".my-app" / "logs",
    on_startup=lambda send: send("Hello from startup!"),
)
VoiceCodingApp(config=config).run()

# Or embed the screen in your own Textual app
screen = VoiceCodingScreen(repo_root, config=config)

Configuration

Settings are stored using platform-standard directories:

Platform	Config	Data	Logs
macOS	~/Library/Application Support/voice-vibecoder/	~/Library/Application Support/voice-vibecoder/	~/Library/Logs/voice-vibecoder/
Linux	~/.config/voice-vibecoder/	~/.local/share/voice-vibecoder/	~/.local/state/voice-vibecoder/log/

Git worktrees are created as siblings of your project directory (e.g., ../my-project-feat-login).

Keyboard Shortcuts

Key	Action
q / Esc	Quit
m	Toggle mute
s	Settings
c	Cancel current Claude task
Space	Push-to-talk (when in PTT mode)

License

MIT