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.appGitHub
Access GitHub repositories, issues, and pull requests.
Everything
Reference / test server with prompts, resources, and tools
Git
Tools to read, search, and manipulate Git repositories
GitLab
GitLab API, enabling project management
Sequential Thinking
Dynamic and reflective problem-solving through thought sequences
Sentry
Retrieving and analyzing issues from Sentry.io