Your voice-first desktop companion for Claude Code.
Say “hey Void” and he does the work.
Install · First steps · Things to try · Features · Full guide · Help
![]() |
Void is a little orb that floats on your desktop. Tell him what you want, and he gets Claude Code to do it in your project. Then he tells you how it went.
|
You need Claude Code first. Install it, then run
claudeonce in a terminal to sign in. Void is the voice and face; Claude Code does the work.
No admin needed. Uninstall from Settings → Apps. |
Ubuntu, Debian, Fedora and Arch. |
Mac version contributed by |
|
Paste it into a terminal:
curl -fsSL https://raw.githubusercontent.com/PLAYER99-void/void/main/get.sh | bashIt sets up Void, his voice and hearing, and starts him. Updates itself from his settings.
Other ways to install (.deb · .rpm · Arch · source)
The line above picks the right package for your system. On a distro without one, it installs from source.
Or download a package yourself (.deb · .rpm · Arch)
Download the one for your distro from the latest release, then:
sudo apt install ./void-claude_*_all.deb |
|
sudo dnf install ./void-claude-*.noarch.rpm |
|
sudo pacman -U ./void-claude-*.pkg.tar.zst |
Then void setup once (his voice and hearing) and void.
Or from source (git clone)
git clone https://github.com/PLAYER99-void/void.git
cd void && ./install.sh
voidIt gets the system packages for you (pacman, apt or dnf) and updates itself with git pull.
Gentoo or system-wide? See the guide.
Download Void.dmg from the latest release, open it and drag Void into Applications. It's for Apple Silicon Macs (M1 or newer). The Mac version was contributed by ohshitgorillas.
The app isn't notarized by Apple, so the first launch is blocked. Open System Settings → Privacy & Security, scroll down and click Open Anyway next to Void. macOS then asks to let him use the microphone and to record the screen: say yes.
| Do this | What happens | |
|---|---|---|
| 1 | Start Void | He appears in the bottom-right corner. Drag him anywhere; he remembers the spot. |
| 2 | Say "hey Void" | His ring lights up and moves with your voice. (Or just click him.) |
| 3 | Ask for something | He works in the current folder. Say "switch to my project" or right-click → folder to change it. |
| 4 | Right-click him | His menu: talk, folder, history, show my screen, hover mode, settings. |
| 5 | Push him into a screen edge | He merges into it as a notch, with just his eyes. Click the notch for his menu (click again to close it). Drag him out to get the orb back. |
Tip
Say "stop" to interrupt him, hold Space for push-to-talk, or just start typing for a text box. Press Esc to back out of anything. Ctrl+N (or saying "new chat") starts a fresh conversation.
| 💻 Coding | 🖥️ Your screen | ⚡ Instant |
|---|---|---|
| "Hey Void, run the tests" | "What's this error on my screen?" | "Timer 10 minutes" |
| "Fix the failing test" | "Explain what I copied" | "Volume up" |
| "What does this project do?" | "Watch my screen" (live view) | "Open firefox" |
| "Make the button blue" | "Did that fix the layout?" | "Remind me at 5 to call mom" |
Before running commands he asks first: say "yes", "no" or "always". Change that in Settings → Brain.
See everything he can do in the full guide →
Run void doctor first. It checks your mic, his voice and Claude Code in a few seconds.
| Problem | Fix |
|---|---|
| He can't hear me | Check the level meter in void doctor, then pick the right mic in Settings → Voice. |
| "I can't find Claude Code" | Install Claude Code and run claude once to sign in. |
| Windows: "DLL load failed" | Install the Visual C++ runtime, then void restart. |
| Something else | Right-click him → Settings → More → Copy diagnostics, then Report a problem and paste it. Or see Troubleshooting. |
| Want to chat or share what you built | Join the Void Discord. |
Speech-to-text by faster-whisper · voice by Kokoro · brains by Claude Code
Everything runs on your computer · MIT license








