TestFlight
Vibe Machine: a guide for testers
Thanks for trying Vibe Machine. It is a cockpit on your iPhone for Claude Code running on your own Mac: you watch each turn as it happens, answer Claude's permission prompts, see the screenshots of what changed, and send the next prompt, from anywhere.
It is an independent app that works with Claude Code. It is not made by, affiliated with or endorsed by Anthropic.
What you need
- An iPhone on iOS 26 with TestFlight installed.
- A Mac with:
- Node 24 or newer (
brew install node, or nodejs.org). - Claude Code, installed and signed in with your own account: run
claudeonce in a terminal and sign in. Vibe Machine never sees your sign-in; it runs theclaudeyou installed. - Your repos in one folder (
~/devby default).
- Node 24 or newer (
- Optional: Tailscale on the Mac and the phone, to reach your Mac away from home. Without it the phone finds the Mac on the same Wi-Fi.
- Optional: Xcode with a simulator, if you want before-and-after screenshots of the iOS apps you work on.
Set up the Mac (about five minutes)
npm install -g vibemachine-daemonvibemachine setupvibemachine doctorvibemachine setup installs and starts the daemon and prints a QR code; vibemachine doctor checks everything, and each ✗ comes with a fix.
The daemon is a small background program on your Mac. It starts at login, runs Claude Code sessions when your phone asks, and streams them to the phone. It listens only on your Mac, your Wi-Fi (encrypted, with a certificate your phone pins when it pairs) and your tailnet if you use Tailscale.
Pair the phone
- Install Vibe Machine from your TestFlight invite.
- Open it and scan the QR code
vibemachine setupprinted (or point the iPhone's Camera at it). No QR code to hand?vibemachine pairprints a fresh one. - That's it: start a session with +, pick a repo, type what you want.
Want a look before setting up the Mac? “Try the demo” on the pairing screen plays a recorded session.
What to try
- Start a session on a small change in one of your repos.
- Answer a permission prompt from the phone (Allow, Always, Deny).
- Open the Stats page: the chart key on the rail, or the ⋯ menu at the top on an iPhone that doesn't fold.
- If you work on an iOS app, add a
.vibemachine.jsonto its repo (see the example) and watch the preview pane after a build.
Notifications and the Live Activity on the Lock Screen aren't on for testers yet; they arrive in an update. Until then the app follows each turn live while it's open.
Sending feedback
- Screenshot feedback: take a screenshot in the app and tap “Share Beta Feedback”, or use the TestFlight app. It reaches the developer directly.
- Crashes are reported through TestFlight automatically.
- Anything else: reply to your invite email, or write to support@getvibemachine.com.
Useful in a report: what you did, what you expected, what happened, and vibemachine doctor's output if it's about the Mac side.
Removing it
Delete the app. On the Mac:
vibemachine uninstall --purge
npm uninstall -g vibemachine-daemonThe first stops the daemon and deletes its sessions, screenshots and keys from ~/Library/Application Support/VibeMachine (leave out --purge to keep them). The second removes the command. Claude Code and its own sessions are untouched.