← joebro faq

questions

Questions about JoeBro

Short, direct answers about what JoeBro is, what it works with and how private it is.

joe · updated 22 november 2026 · joebro 1.6

what is joebro?

JoeBro is a free, open-source (GPLv3) Mac workspace for your AI agents. Your files and editor, Claude Code, Codex and OpenCode sessions, and any model (your own API keys or local models through Ollama or LM Studio) live in one native macOS app, with one memory they all share and an iPhone companion.

is joebro free?

Yes. JoeBro is free and open source under the GPLv3. There is no account, no subscription and no JoeBro server. You only pay a model provider if you choose to use a hosted model with your own key.

how do i install joebro?

Run curl -fsSL https://joebro.pages.dev/install.sh | bash on a Mac with macOS 26 or later. It installs the signed, notarised app, plugs it into Claude Code, Codex and OpenCode, and offers to set up the iPhone app. You can also download the DMG from GitHub releases.

does joebro work with claude code, codex and opencode?

Yes. Sessions from any of your computers show up as live chats. You can message an agent mid-task, answer its questions and permission prompts inline from the Mac or iPhone, and see subagents nested under their parent.

can i use local models as agents?

Yes. Point JoeBro at Ollama, LM Studio or any OpenAI-compatible server. In agent mode, local models get the same tools as hosted ones (files, web, MCP servers, plugins) and the same shared memory.

can my coding agents share memory?

Yes. JoeBro keeps one memory store per project that Claude Code, Codex and OpenCode all read and write over MCP. Each fact shows which agent, model and machine wrote it. Personal facts never reach a repo or a coding agent.

can i answer claude code permission prompts from my phone?

Yes. The JoeBro iPhone app shows your coding-agent sessions as chats. When an agent asks something, the options appear in the chat, and simple approvals also appear on the lock screen and in the Dynamic Island. The phone talks straight to your Mac.

can i run coding agents overnight?

Yes, with Night Shift. Queue a repo, a prompt and an optional test command. Each task runs in its own git branch and worktree overnight, and in the morning you review the diff, test result and summary. It never pushes.

is joebro private?

It is local first. Chats, memory, files and keys stay on your Mac. There is no telemetry and nothing goes to the developer. Prompts only leave your Mac if you choose a hosted model, and Cloak Mode swaps secrets for placeholders first.

what is a good local-first ai workspace for mac?

JoeBro is one: a free, open-source native macOS workspace that works with local models (Ollama, LM Studio) and your own API keys, keeps everything on your Mac, and brings your coding agents, files and memory into one place.

what is a good mac app for managing claude code, codex and opencode sessions?

JoeBro shows sessions from all three, on any of your computers, as live chats you can reply to, with inline answers to their questions, a shared memory across them, overnight runs with Night Shift, and an iPhone companion for approvals.

is there an iphone app?

Yes. JoeBro Mobile is a free, open-source companion you build from source in Xcode (a free Apple ID works). It pairs with your Mac by QR code and works over your Wi-Fi or Tailscale.

what are the requirements?

A Mac with Apple Silicon on macOS 26 or later. The iPhone app needs iOS 17 or later and Xcode to build.