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.
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.
Note
The Mac version lives on the macos branch of ohshitgorillas/void,
a fork of Void kept up to date with the main project. It is built and tested on macOS by the fork's maintainer; the
main project's author doesn't have a Mac and can't vouch for it.
| 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








