{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "simon-ai-coding-gpt-voicecoding--run-bridge-engine-without-menu-bar-app",
 "repo": "Simon-AI-coding/GPT-VoiceCoding",
 "repo_url": "https://github.com/Simon-AI-coding/GPT-VoiceCoding",
 "repo_slug": "simon-ai-coding-gpt-voicecoding",
 "title": "Run the bridge engine headless from a config file",
 "page_title": "How to run the bridge engine headless from a config file with GPT Voice Coding",
 "summary": "Start the Python engine directly with a config file instead of through the menu-bar app.",
 "who": "A developer who wants to run the bridge from a terminal or script on a Mac, for example to test changes to the engine.",
 "problem": "The menu-bar app is the default way in, but a developer may need the engine running on its own to inspect or modify it.",
 "outcome": "A single Python asyncio engine runs from the command line and watches your sessions without the menu-bar app open.",
 "steps": [
  "Clone the repository with `git clone https://github.com/Simon-AI-coding/GPT-VoiceCoding.git` and 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 with `pip 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."
 ],
 "agent_prompt": "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.",
 "agents": [
  "claude-code",
  "codex"
 ],
 "difficulty": "Advanced",
 "time": "1 hour",
 "basis": "readme",
 "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.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "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"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/simon-ai-coding-gpt-voicecoding/run-bridge-engine-without-menu-bar-app/",
 "md": "https://dedupedai.com/use-cases/simon-ai-coding-gpt-voicecoding/run-bridge-engine-without-menu-bar-app/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/simon-ai-coding-gpt-voicecoding--run-bridge-engine-without-menu-bar-app.json",
 "api_version": "v1"
}