VibePit
Before you begin
Please check that you have the following. VibePit installs Claude Code for you if it is missing.
macOS 12 or later, with a microphone. A Mac with Apple silicon (M1 or later) runs the speech models fastest.
An account that can use Claude Code: Pro, Max, Team or Enterprise, or an API key. VibePit uses your own account.
Recommended. Each project opens in a VS Code window, with Claude in its terminal panel. You can use Terminal instead.
Most of this time is the first download of the speech models. It happens only once.
Which download do I need? Open the Apple menu and choose About This Mac. If the line Chip says Apple M1, M2, M3 or later, choose Apple silicon. If it says Processor and Intel, choose the Intel download.
1. Install VibePit
- Download the disk image for your Mac from the button above. The file is called VibePit-arm64.dmg (Apple silicon) or VibePit-x86_64.dmg (Intel).
- Open the disk image from your Downloads folder, and drag VibePit into the Applications folder.
- Open VibePit from Applications or Launchpad.
- Allow it to open, the first time only. macOS may say that it cannot check VibePit for malicious software. This is expected. Open System Settings → Privacy & Security, scroll down, press Open Anyway next to VibePit, and confirm. You only need to do this once.
2. Follow the Get started card
When VibePit opens, the Overview page shows a Get started card. It has one button for each remaining step. Each step ticks itself off when it is done, so you always know what is left.
If Claude Code is not on your Mac yet, press the button and VibePit installs it for you.
Press the button to log in with your Claude account. Your browser opens so that you can sign in safely with Claude. VibePit never sees your password.
If VS Code is not installed, the button takes you to its download. VibePit then adds a small extension to VS Code, which lets it open named Claude tabs. If you prefer Terminal, choose Use Terminal instead.
VibePit adds a small setting to Claude Code, so that it can tell you when Claude is done or needs you. If the Overview says the alerts are missing, press Install alerts there.
The last step takes you to the Projects page. The next section explains it.
3. Add your projects
A project is a folder on your Mac with code in it. Each project gets a short name that you say, such as abc
.
On the Projects page, press Set up with Claude. VibePit finds the projects on your Mac and suggests a short, easy name to say for each one. Tick the ones you want and press Add. Claude sees only the project names, their top-level files and their READMEs, and it cannot change anything.
Press + New project, type a name, and choose its folder.
Short, distinct names work best. You can add aliases, other ways of saying the same name, and vocabulary, words that Claude often hears in that project, such as Prisma or Next.js.
For each project you can choose which Claude account it uses, the mode new Claude sessions start in, and terminals that open with it, such as a dev server.
4. Start listening
- Press Start on the Overview.
- Allow the microphone. macOS asks once whether VibePit may use the microphone. Please press Allow, or VibePit cannot hear you.
- Wait for the speech models. The first time, the speech models download. This can take a few minutes. On macOS 26, VibePit uses the Mac’s own speech recognition; on older versions it uses Whisper, which runs on your Mac.
- Look for the menu bar icon. The VibePit logo appears in the menu bar. It shows that VibePit is listening, and you can start and stop listening from it.
5. Your first task
- Open a project. Say
Hey Pit, open abc
, using the name of one of your projects. VS Code opens the project with a Claude tab called abc-claude. - Tell Claude what to do. Say it in your own words, for example
why is the login test failing?
You can also type it in the Chat. - Follow along, or walk away. The Chat shows what Claude is doing while it works. You do not need to watch it.
- Answer when Claude asks. If Claude needs your permission, you hear
abc-claude needs you
. Answer with one click in the Chat, or sayapprove
orreject
. You can also answer from your phone. - Hear the result. When Claude finishes, you hear
abc-claude is done
and a short summary of what it did.
Everyday use
Start with Hey Pit
. For 30 seconds after each command, you can keep talking without the name. Everything you can say, you can also type in the Chat. Press ⌘K to jump to the message box.
VibePit works out whether you gave a command or wrote a message for Claude. To be sure, begin with Pit, …
for a command, or with Claude, …
for a message. If a sentence could mean two things, VibePit asks you.
Say in abc, …
to send a message to a project that is already open, while you keep working in another one.
The Chat shows each Claude tab’s conversation, what Claude is doing right now, and its answers. Questions, permission requests and plans appear there with buttons to answer.
In plan mode, a plan opens beside the Chat, laid out like a document. Approve it, or write what should change; press Shift+Return for a new line. You can also pin a plan or branch it into a new session.
Press Reply on one answer to talk about just that answer. When Claude writes a message for someone, Copy the message to … copies it ready to paste. Links from an answer, such as pull requests and reviews, sit under its headline.
Each Claude tab has a mode. In plan mode, Claude researches and proposes a plan before it changes any files. In accept edits mode, it edits files without asking each time. You can change the mode from the Chat.
While VibePit is in the background, a small panel shows whether each Claude tab is ready, working or needs you. Click it to go back to that conversation.
The Chat shows how much of your 5-hour and weekly Claude limits you have used, and how full the conversation is. Your week shows the last 7 days for each project.
Pin an answer, or keep notes, checklists and reminders on one board. Claude can suggest one when you ask for a plan or a reminder; nothing is saved until you approve it.
On your phone
Your phone can use VibePit in its web browser, with nothing to install. It can send messages, answer Claude, stop a tab, attach photos, and show background tasks and changes.
- Make a QR code. Open On your phone in VibePit, choose one project or every project, and press Make a QR code. You can also press the phone icon in the message box.
- Scan it. Point your phone’s camera at the code and open the link. Each code works once, for two minutes.
- Press Allow on the Mac. The phone waits until you let it in. Then it shows your Claude tabs.
- Open it again later. If you close the page on your phone, click Scan to open again beside the phone on the Mac for a new code. You can also add VibePit to your phone’s Home screen.
By default, the phone and the Mac need the same Wi-Fi. The link stays on your network but is not encrypted, so use a network you trust.
Choose Anywhere to connect from outside, through an encrypted Cloudflare link. Install Cloudflare’s free cloudflared on the Mac first: brew install cloudflared. The phone’s microphone works only over this link.
Disconnect a phone from the Mac or from the phone at any time, give it a time limit, or remember it on your Wi-Fi.
Useful phrases
These phrases are a good start. The app’s Voice commands page lists everything you can say. To put things in your own words instead, download the optional understanding model (about 1.8 GB) in Voice & listening → Understanding. It runs on your Mac.
open abc
Opens the project in VS Code, with its Claude tab.
in abc, check my last change
Sends the message to that project’s Claude tab.
plan the Prisma upgrade
Claude first researches and proposes a plan, before it edits anything.
approve·
always allow·
reject
Answers Claude’s permission request.
is abc done?
Tells you what that Claude tab is doing.
what did abc change?
Tells you which files are not committed, and whether commits are waiting to be pushed.
review PR 42
Claude reviews that pull request with your review instructions.
resume abc
Continues that tab’s last Claude conversation.
Optional extras
Say Hey Pit, learn my voice
and read five short sentences. VibePit then ignores other people speaking near you. It helps, but it is not a lock: a recording of you, or a very similar voice, can still pass.
Add it on the Claude accounts page, then choose it for the projects that should use it. If one account is close to its limit, VibePit offers to move the conversation to the other.
Say dictate
to type into any app, such as Slack or your browser. This needs the Accessibility permission: System Settings → Privacy & Security → Accessibility.
Add your own Deepgram key in Voice & listening → Microphone for faster and more accurate speech recognition.
If you prefer, what you say is placed in the message box first. You can correct any misheard words and then press Return.
Say Hey Pit, change your name to Friday
, or change it in Voice & listening → Name & waking. Short, distinct names are recognised best.
Choose Dark, Light or System in General → Appearance.
Your settings
Settings are on three pages: Voice & listening, Claude behaviour and General. Each page is divided into tabs, such as Microphone, Reviews or Updates. To find a setting quickly, type a word from it in the Find a setting box at the top of the page. If the setting is on another page, a link takes you there.
Your privacy
Your speech is turned into text on your Mac. If you download the optional understanding model, it also runs on your Mac and works out what you meant. No audio or words leave your Mac, unless you add your own Deepgram key; then only what you say to VibePit is sent to Deepgram, after it hears its name. There is no VibePit account. The app only talks to itself on 127.0.0.1, and every request needs a secret token. Your messages to Claude go through your own Claude Code, as they would if you typed them.
If something goes wrong
It does not hear me, or it reacts to noise
Check that the microphone is allowed in System Settings → Privacy & Security → Microphone. The Mic threshold setting in Voice & listening → Microphone changes how loud speech must be before VibePit listens.
It mishears a project name
Right after it says that it does not know a project, say I meant abc
. VibePit remembers the misheard words for next time. You can also add aliases to the project.
I do not hear “is done” alerts
Restart your Claude tabs after you install VibePit. If the Overview says the alerts are missing, press Install alerts there. Alerts work in the Claude tabs that VibePit opened, while VibePit is running.
Claude opens in Terminal, not in VS Code
In VS Code, open the command palette with ⌘⇧P and run Developer: Reload Window. Then try again.
My phone does not connect
Check that the phone is on the same Wi-Fi as the Mac, or choose Anywhere. A code works once, for two minutes, so make a new one if it has run out. If the phone says the code is in use, another phone has it; make a new code for this one.
VibePit stopped listening
On the Overview, press Show log to see why, and then press Start again.
macOS says it cannot check the app
Open System Settings → Privacy & Security, scroll down, and press Open Anyway next to VibePit. You only need to do this once.
Updates and uninstalling
When a new version is available, VibePit tells you. Press Update now. The app installs the update and opens again, and your projects and settings are kept. To check for a new version yourself, open General → Updates and press Check now. The release notes explain what is new in each version, and the app’s What’s new page shows them too.
Quit VibePit. In Terminal, run ~/.vibepit/app/.venv/bin/python ~/.vibepit/app/install_hooks.py --remove to remove the spoken alerts from Claude Code. Then drag VibePit to the Trash, and delete the ~/.vibepit folder.