bettercallgpt

Put Claude Code on a voice call

Talk while it codes. GPT Realtime talks back. A spoken “yes” never approves anything.

Demo  •  Install  •  How it works  •  Guide  •  简体中文

Better Call GPT

Say what you want while you do something else. A realtime voice model keeps the conversation;
only real requests reach your Claude Code session, which does the work in your repo and reports
back by voice. In the launch video: fix a Stripe refund bug, draft an email you approve before it sends,
and learn a Sylas combo, all mid-game.

▶ 86-second demo with sound

How a call works

sequenceDiagram
    participant You
    participant GPT as GPT Realtime
    participant CC as Claude Code (your session)
    You->>GPT: speak: "fix the refund bug and ship it"
    GPT-->>You: small talk is answered right here
    GPT->>CC: real requests arrive as a line tagged ⟨v#35;1⟩
    CC->>CC: reads, edits, runs tests, pushes
    CC-->>GPT: progress and results
    GPT-->>You: reads them back, you can interrupt any time
    Note over You,CC: Permission prompts go to your keyboard only. The voice cannot approve.

1. /bettercallgpt:on starts a voice process bound to this session only. It proves which
   session started it with zero keystrokes and refuses anything else.
2. You talk, full duplex, in your language. It opens in Chinese and answers in whatever
   language you just spoke; English tech words don't switch it. GPT Realtime decides what is chat
   and what is work.
3. Work is relayed as your words, tagged ⟨v#n⟩, so Claude treats it as you speaking.
4. Results come back by voice when they land; ask “how's it going?” mid-task.
5. It ends when you say so, type /bettercallgpt:off, or stay quiet for 10 minutes.

Install once

npx skills add insta-fusion/bettercallgpt -g      # needs Node; macOS + Claude Code

Then tell your agent: “set up bettercallgpt”. No Node? Paste this into Claude Code instead:
Set up https://github.com/insta-fusion/bettercallgpt for me. (it follows AGENTS.md). It checks for uv
and your platform, installs the Claude Code plugin, creates an empty key file and runs a
readiness check. You do two things yourself:

1. Paste your key into the file it names (Azure Voice Live; OpenAI Realtime is
   experimental). Setup never asks for the key — don't paste it into the chat.
2. Type /bettercallgpt:on in a new Claude Code session and approve the start. A rising tone:
   you're live.

Better Call GPT is free and MIT; the voice service bills your own account. Prefer to skip the skill?
Install uv, type /plugin marketplace add insta-fusion/bettercallgpt
and /plugin install bettercallgpt@bettercallgpt, fill ~/.config/bettercallgpt/.env from
.env.example, then /bettercallgpt:on.

Or pin the release without the skill: uv tool install "git+https://github.com/insta-fusion/[email protected]".

Speakers or headphones? Pick the voice model

If the AI ever cuts itself off mid-sentence while on speakers, put on headphones or switch to
Voice Live (delete the VOICE_LIVE_PROVIDER=gpt_live line).

Commands

Safe by design

• A spoken “yes” never approves anything. The voice cannot answer a permission prompt; you
  answer it on the keyboard. (What your agent may already do without asking is still up to your
  Claude Code permission settings.)
• The start asks you first — unless Claude Code runs in auto or bypass mode, or an allow rule
  matches it. Don't allow-list it (no bettercallgpt wildcard, no broad
  uvx rule): it opens your microphone and a paid connection.
• What leaves your machine: your microphone audio, and what the voice needs to talk about the
  work (your prompts, the agent's progress and results, permission prompts), go to the voice
  provider you configure. The call ledger stays local (0600). See
  SECURITY.md › Privacy notes.
• It attaches only to the session that started it, proven with zero keystrokes, and refuses
  anything else.
• The plugin is three small command files (plugin/commands/) that only
  you can run: no hooks, and the voice process runs only during a call. They run the tagged
  release from GitHub through uvx; release tags are published as immutable GitHub releases,
  so a tag cannot be moved after release.

Works with

Want it in another coding agent or CLI (Codex, Gemini CLI, Cursor, Aider, …) or on another voice model or OS? Open a support request and say which one; requests decide what comes next.

More

Status line, running without the plugin, configuration, how it is built and tests: docs/GUIDE.md.

License

MIT — see LICENSE.