Mac Developer Bridge
Mac Developer Bridge turns a ChatGPT conversation into the reasoning layer for your actual Mac. It can run shell commands, edit files, start interactive terminal sessions, manage long-running jobs, an
Mac Developer Bridge turns a ChatGPT conversation into the reasoning layer for your actual Mac. It can run shell commands, edit files, start interactive terminal sessions, manage long-running jobs, an
Features
Category
For a personal ChatGPT account, the menu-bar app is the easiest path. You need macOS, Node.js 18+, `cloudflared`, a hostname/tunnel, and ChatGPT Developer mode. ```bash git clone https://github.com/alexanderradahl/mac-developer-bridge.git cd mac-developer-bridge ./menubar/build.sh open /Applications/MacDevBridge.app ``` Use **Start**, then **Copy ChatGPT Setup** from the menu-bar app. The detailed OAuth and Cloudflare setup is in [Connecting to ChatGPT](#connecting-to-chatgpt) and [DEPLOY.md](DEPLOY.md). Workspace users who have access to OpenAI Secure MCP Tunnel can use `install.sh` instead. See [Transports](#transports). Want to see what to ask it to do? Start with the [copy-paste workflows](examples/README.md). If this is useful, star the repo so other developers can find it. If you build something interesting with it, share the exact workflow in [What are you making ChatGPT do on your Mac?](https://github.com/alexanderradahl/mac-developer-bridge/discussions/3). This is an independent open-source project and is not an official OpenAI or Cloudflare product. OpenAI, ChatGPT, Codex, and Cloudflare are trademarks of their respective owners.
bridge_status
Runtime identity, paths, permissions context, shell, audit mode, and Codex binary
shell_exec
Run any foreground shell command, optionally with cwd, env, stdin, timeout, and output cap
shell_start
Start a detached long-running process
shell_job_status
Inspect running state and log tails
shell_job_list
List persistent job metadata
shell_job_kill
Signal a background process group
fs_read
Read text or base64 with offset pagination
fs_write
Atomic replace, create, append, or binary write
fs_list
Recursive or non-recursive directory listing
fs_stat
lstat metadata and symlink target
fs_manage
mkdir, remove, move, copy, chmod, or symlink
apply_patch
Apply or check a unified diff with `git apply`
codex_thread_read
Read a stored Codex thread without resuming it
codex_thread_list
Search and page stored Codex threads
codex_thread_turns_list
Page stored turns with full, summary, or omitted items
audit_tail
Read the local bridge audit tail
pty_start
Start a program on a real terminal and return a session id
pty_read
Read the transcript from a byte cursor, optionally long-polling
pty_write
Send keystrokes, including control characters
pty_resize
Change the window size, confirmed by a kernel read-back
pty_signal
Signal the session's process group
pty_close
End the session and reclaim it
git clone https://github.com/alexanderradahl/mac-developer-bridge.git
cd mac-developer-bridge
./menubar/build.sh
open /Applications/MacDevBridge.appTseha.io (Claude)
Your coding standards, live in Claude
Bronto (Claude)
Query your Observability data in plain language, then turn what you find into monitors, saved searches, and Investigation Reports.
Breezing (Claude)
Crypto accounting for Xero, QuickBooks and Bexio Alternative: Categorize, reconcile and book crypto in your ledger
Vercel (Claude)
Analyze, debug, and manage projects and deployments
Claude Academy (Claude)
Search and read Claude Academy courses and tutorials
OnChainDiligence (Claude)
Inspect autonomous payments before execution and independently verify evidence afterward.