Olaf The Vibecoder
Talk to your codebase like a colleague. You speak an idea; Olaf holds a natural voice conversation while coding agents (Claude Code and friends) quietly build it on separate git branches. Ask to see the diff, say "merge it", and it lands on main — the whole loop, hands-free.
you: "lag en fil med et dikt i repoet"
olaf: "Klart, jeg setter i gang!" → agent builds on branch 'dikt'
you: "vis diff" → colorized diff in the TUI
you: "merge det inn i main"
olaf: "Ferdig! Dikt er merget inn i main."
Quick Start
# Install and run
uv tool install voice-vibecoder
vibecoder
On first launch, a setup wizard will guide you through connecting your OpenAI or Azure OpenAI account. Press s anytime to change settings.
Features
- Natural conversation — full-duplex voice: interrupt Olaf mid-sentence and it stops and listens (system echo cancellation on macOS, adaptive echo gate elsewhere). Short spoken answers, follows your language, resumes previous conversations where they left off
- Invisible agent orchestration — multi-instance Claude Code agents in separate git worktrees; Olaf narrates progress and delivers results
- Voice-driven git — show diffs, merge branches into main, clean up worktrees, all by voice; conflicts are reported, never half-merged
- Live file tree per agent (including files the agent just created) and GitHub-style diff view
- Session persistence across restarts
- Push-to-talk and voice activity detection modes
- OpenAI and Azure OpenAI realtime (GA voices marin/cedar), Gemini Live
- Multi-language (English, Norwegian, Swedish) — spoken and transcribed
Requirements
- Python 3.10+
- An OpenAI API key with Realtime API access
- PortAudio for microphone input (
brew install portaudioon 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
1 maintainer
Release files for voice-vibecoder 2.31.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| voice_vibecoder-2.31.1.tar.gz | 119.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| voice_vibecoder-2.31.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 237.7 kB
Release files / voice_vibecoder-2.31.1.tar.gz
| Download URL | voice_vibecoder-2.31.1.tar.gz |
|---|---|
| Size | 119.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72dfc38f1bee04a836fdde61bc954c2998dd29725a07e632b120cb847eca5a81
|
|
BLAKE2b-256 checksum How to use checksums |
820f56589581df587ed04906d4650d0c6422057ace2745be71582186c857b2bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency logRelease files / voice_vibecoder-2.31.1-py3-none-any.whl
| Download URL | voice_vibecoder-2.31.1-py3-none-any.whl |
|---|---|
| Size | 117.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ad32d3cca852c19e7a91e692286884c6c8eedafe51d81487185baa4ded0a8c26
|
|
BLAKE2b-256 checksum How to use checksums |
7be96becfd11c3763918440b4289600409561112cd6618830bcdc13d07d63b90
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 8, 2026.
Transparency log
