Who it is forA developer who wants to run the bridge from a terminal or script on a Mac, for example to test changes to the engine.
The problemThe menu-bar app is the default way in, but a developer may need the engine running on its own to inspect or modify it.
The outcomeA single Python asyncio engine runs from the command line and watches your sessions without the menu-bar app open.
What you need first
- An Apple Silicon Mac with Apple's Command Line Tools (xcode-select --install)
- Python 3.12 or newer available as python3 on your PATH
- Claude Code or Codex installed
- Codex signed in with a ChatGPT account (codex login), needed for the Live Call
- Telegram account, optional, for the second reply route
Steps
- Clone the repository with
git clone https://github.com/Simon-AI-coding/GPT-VoiceCoding.gitand change into the folder. (inferred, check the README) - Install the package from the repo root with
pip install -e ., then add the optional audio path withpip install 'gpt-voicecoding[voice]'if you need the Live Call. (inferred, check the README) - Write a configuration file following docs/control-plane.md in the repo.
- Run
python -m gpt_voicecoding.engine --config <path-to-config>in Terminal. (inferred, check the README) - Read docs/control-plane.md and docs/adr/0001-hub-and-spoke-bridge-core-with-seams.md to see which seams and adapters the engine uses.
Prompt for your agent
Using the repo Simon-AI-coding/GPT-VoiceCoding, install the package from source and start the engine with python -m gpt_voicecoding.engine --config <config-file>. Report the engine startup output and the path of the config used. Verify by confirming the process stays running without the menu-bar app open.
Caveat. The README gives the engine command and the voice extra install but not the base install command or the config file format, which live in docs/control-plane.md.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for Simon-AI-coding/GPT-VoiceCoding and "Run the bridge engine headless from a config file"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer