Help
Most problems are one of the six below. If yours isn’t, open Pintail → Settings → Feedback and tell me; app details are attached if you leave them on.
Pip is silent
- Open the menu bar duck. If it says the trial or credits ran out, that’s the reason; the button next to it fixes it.
- Settings → Setup: Claude Code (or Codex) has to show as connected. If it isn’t, click Connect, then start a new session in your terminal.
- Automatic reading may be off. Press ⌃⌥R to read the tab you’re in, or turn it on in the menu.
- Settings → General → Test voice. If that’s silent too, check your Mac’s volume and output device.
- Talking or dictating pauses Pip on purpose (“Quiet when you talk”). It goes on once the microphone is off.
Permissions
- Automation (asked the first time it’s needed): lets Pintail switch to the terminal tab that’s talking, and turn Spotify or Apple Music down while Pip speaks. Say no and both just don’t happen. Change it later in System Settings → Privacy & Security → Automation.
- Accessibility: only for ⌃⌥E, which reads what you’ve selected in any app. System Settings → Privacy & Security → Accessibility → Pintail on.
Codex stays quiet
Codex runs new hooks only after you trust them. In Codex, type /hooks and trust the two Pintail hooks. Settings → Setup shows a warning until you have.
Credits or your own key
- The cloud voice needs one of the two: your own OpenRouter key, or Pintail credits bought in the app (Settings → License & credits).
- If your own key is saved, it goes first and credits wait. Remove the key to use credits.
- Credits belong to the Mac you bought them on. Moving to a new Mac? Write to me before you wipe the old one.
A new Mac
One license works on up to 3 Macs. On the old Mac: Settings → License → Move to another Mac. That frees a spot; then enter the key on the new one. Old Mac already gone? Write to hello@soulrise.us and I free the spot for you. Lost the key? It’s in the email from Lemon Squeezy, or write to me.
Uninstall
Settings → General → Uninstall. Pip leaves Claude Code and Codex, and the app goes to the Trash. Dragging the app to the Trash yourself is safe too: the hooks skip a missing app. Your settings and credits stay in ~/Library/Application Support/Pintail; delete that folder to remove everything.