Skip to content
PLAYER99-voidPublic

About

A voice-first desktop companion for Claude Code. Say "hey Void" and a little orb (or a notch in your screen's edge) does the work. Windows and Linux, 100% local voice.

Topics

Resources

Stars

50 stars

Watchers

0 watching

Forks

Repository files navigation

Void

Void

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

Latest release Installer tests MIT license

Join our Discord


Void talking, captions appearing word by word

Talk to your code

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.

  • 🎙️ Just say it. "Hey Void, fix the failing tests."
  • 👀 Watch him work. He holds up a tiny terminal so you see every step.
  • 🔒 Private. Your voice never leaves your computer.
  • ✨ Out of your way. No app window, no taskbar button. Just him.
  • 🔝 Or tuck him into your screen's edge. Push him to any edge and he becomes a MacBook-style notch.

Install

You need Claude Code first. Install it, then run claude once in a terminal to sign in. Void is the voice and face; Claude Code does the work.

Windows 10 / 11 Linux

Download VoidSetup.exe for Windows

  1. Download VoidSetup.exe and run it.
  2. Wait a few minutes while it sets up his voice and hearing.
  3. Find Void in your Start menu.

No admin needed. Uninstall from Settings → Apps.
"Windows protected your PC"? Click More info → Run anyway.

Copy the one-line Linux install

  1. Paste the line below into a terminal.
  2. Wait a few minutes while it sets up his voice and hearing.
  3. Run void.

Ubuntu, Debian, Fedora and Arch.
Other ways to install are below.

macOS

Get Void.dmg

  1. Download Void.dmg (Apple Silicon).
  2. Drag Void into Applications.
  3. Open it (steps below).

Mac version contributed by
ohshitgorillas.

Linux: one-line install

Paste it into a terminal:

curl -fsSL https://raw.githubusercontent.com/PLAYER99-void/void/main/get.sh | bash

It sets up Void, his voice and hearing, and starts him. Updates itself from his settings.

Other ways to install (.deb · .rpm · Arch · source)

Ubuntu Debian Fedora Arch Linux

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 .deb for Ubuntu and Debian
Download the .rpm for Fedora
Download the package for Arch Linux

Download the one for your distro from the latest release, then:

Ubuntu / Debian sudo apt install ./void-claude_*_all.deb
Fedora sudo dnf install ./void-claude-*.noarch.rpm
Arch Linux 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
void

It gets the system packages for you (pacman, apt or dnf) and updates itself with git pull.

Gentoo or system-wide? See the guide.

macOS

macOS on Apple Silicon

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.

Your first two minutes

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.

Things to try

💻 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.

Meet him

Void working on his little terminal
He does the work
Reads, edits and runs commands on a little terminal he holds like a sheet of paper.
Void listening, his ring moving with your voice
He listens
Say "hey Void", click him, or keep talking right after he answers.
Void cycling through his moods
He reacts
Happy, curious, shy, sleepy, starry-eyed… his face follows what he says, word by word.
Void trying on skins and colours
Dress him up
Cat ears, halo, crown, headphones, a bow, and any colours you like.
Void being petted
Pet him
Rub the mouse over him and he purrs. Click him too much and he dodges.
Void remembering where your blog is, then switching to it
He remembers
Say "remember my blog is in ~/code/blog" and he knows it in every chat.
Void as a notch at the top of the screen: listening, talking, running a command, and his menu
He becomes a notch
He glows while you talk, and his words and commands drop out of the notch. Clicks go through to what's under it.
Void merging into the top, right, bottom and left edges of the screen
Top, bottom, left or right
Drag him into any edge and he melts into it. Drag him out and he's the orb again. Windows and Linux.

See everything he can do in the full guide →

Need help?

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

About

A voice-first desktop companion for Claude Code. Say "hey Void" and a little orb (or a notch in your screen's edge) does the work. Windows and Linux, 100% local voice.

Topics

Resources

Stars

50 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages