[go: up one dir, main page]

Free · Mac · iPhone · your own hardware

All your agents. One umbrella.

JoeBro is the free way to bring the agents you already use under one umbrella. Claude Code, Codex and OpenCode, plus your own API keys and local models, all in one place on your Mac, your iPhone and your own hardware. Your chats, documents and memory stay on your machine.

v1.5.0 · macOS 26 or later on Apple Silicon · Free and open source (GPLv3)

Your Mac, your iPhone, your Pi, your memory, your model, your tools. No cloud in the middle.

01 · appNative SwiftUIA real Mac app. No Electron.
02 · backendZero dependenciesA Python standard-library backend, bundled inside.
03 · modelsYour modelsOllama locally, or your own API key.
04 · accountNo accountNothing to sign up for. Nothing to install.
Features

One window, not ten apps.

Write together

Chat with any model, with streaming, extended thinking and a real agent mode. Documents open right beside the conversation, including real Word .doc and .docx files, edited in place. Deep Research reads many sources and writes a cited report.

JoeBro chat with a recipe document open beside the conversation
The Brain memory map in JoeBro
JoeBro answering through the git MCP server
JoeBro with a glass theme over a wallpaper
JoeBro Mobile

Your agent, in your pocket

One chat that follows you, running on your own Mac. No cloud in the middle. Tasks run quietly in the background and only ping you when something changed. It is a source release: you build it yourself with Xcode.

Phone agent

One chat that follows you

It runs on your own Mac and pings you when something needs you.

Any news from Rui?He pushed the schedule page. Want me to reply?
Pairing

Scan once. Done

Scan the QR code on your Mac and you are in. No account, no cloud.

Memory

Notes it can read

Plain Markdown files you can open and edit, on the phone or the Mac.

# about-me
- Freelance designer
- Prefers short answers
Inbox

Pings, not noise

Every notice lands in one inbox. Select all and clear it in one go.

Invoice overdueWant me to draft a nudge?Morning briefingTwo meetings todayRain tomorrowTake the jacket
JoeBro Mobile tasks on iPhone
Runs where you are

Your Mac. Or your Pi

The backend ships inside the Mac app and starts with it. That is the documented setup. I run mine headless on a Raspberry Pi so it stays reachable without leaving a Mac awake; that is my personal arrangement, not a supported installer.

New in 1.5

Work while you sleep. Remember across agents

Night Shift, Shared Memory, live subagents and session resume. They work with the agents you already have, not instead of them.

Night Shift

Queue coding tasks before bed. They run overnight, each in its own git branch, on whichever machine has the repo. In the morning you get review cards with the diff, the test result and a summary. Approve or reject from the lock screen. It never pushes.

Night Shift review cards with a diff, test result and summary
Shared Memory

One project memory that Claude Code, Codex and OpenCode all read and write over MCP. It holds what your agents learn as they work: decisions, gotchas, what was tried. Each session starts with a short brief, capped at about 400 tokens. Facts get stronger when used and fade when not. Nothing is deleted. Your personal facts never reach a repo or a coding agent.

The Memory screen listing facts with the agent that wrote each one
Live agents and subagents

Agents and the subagents they spawn show up in the Agents tab and the Dynamic Island as they start, even with the app in the background.

Agents and their subagents listed live
Pick up where you left off

Ask the personal agent to resume a coding session, for example “pick up what I was working on yesterday and add tests”.

Resuming a recent coding session

Needs JoeBro 1.5. The morning briefing and proactive mode are now in the shipped app too.

Coding agents & plugins

Your coding agents check in

Link Claude Code, Codex and opencode to your own JoeBro. They show up beside everything else JoeBro is doing: on the Mac, on the phone and in the Dynamic Island. When one is stuck on a permission prompt, you can approve it from the lock screen.

Then make JoeBro do new things

A plugin is a folder with one manifest. It can give JoeBro new tools, a rule it follows on every turn, and a panel of its own in the Mac app. Write one yourself, or ask JoeBro or any coding agent to build it for you.

plant-care/joebro-plugin.json
{
  "schema": "joebro.plugin/1",
  "name": "Plant care",
  "permission": "sandbox",
  "contributes": {
    "tools": ["plants_due", "plant_watered"],
    "guardrail": "When I mention watering
      a plant, record it.",
    "panels": [{ "title": "Plants",
                 "entry": "ui/index.html" }]
  }
}
01 · toolsNew things it can do

Plain Python functions, or any MCP server in any language. Each runs in its own process with a private data folder.

plants_due() → ["Monstera", "Fern"]
02 · guardrailA rule on every turn

While the plugin is on, its guardrail joins every conversation.

“I watered the fern” → plant_watered("Fern")
03 · panelIts own panel

An HTML page in the Mac app’s Plugins tab. No network: it can only talk to its own plugin.

Built by your agents

Ask Claude Code or Codex for a plugin. The MCP server hands it the spec, then installs, tests and rolls back what it builds.

Off until you say so

A new plugin arrives switched off, with a ping saying what it adds. Installs are staged and atomic, and the previous version is kept.

Pings, not spam

Any agent can ping your phone when it is done or stuck: at most one a minute and 30 a day per agent.

joebro-plugins · MITOne Python file. No account.

Hooks, the MCP server and the plugin tools all talk to your own backend and nothing else.

Get joebro-plugins
$ git clone https://github.com/joexk1/joebro-plugins ~/.joebro-plugins
$ python3 ~/.joebro-plugins/bin/joebro-agents install
$ joebro-agents link http://127.0.0.1:8771
# Claude Code: /plugin marketplace add joexk1/joebro-plugins

Needs JoeBro 1.4. Lock-screen Approve and Deny work when the agent runs in kitty or tmux on a linked computer; otherwise the notification still tells you it is waiting.

Privacy & sovereignty

AI is better when it knows you. So keep it close

What you type · on your Mac

Book the Lisbon flights on my card 4929 1234 5678 9012, the airline password is hunter2-lisboa, and use my API key sk-proj-7Hf2kQa9Lx for the price check.

Cloak Mode
What the model receives

Book the Lisbon flights on my card 4929 1234 5678 9012[CARD NUMBER], the airline password is hunter2-lisboa[PASSWORD], and use my API key sk-proj-7Hf2kQa9Lx[API KEY] for the price check.

Illustrative example. Cloak Mode is on by default and swaps detected values for placeholders before any request leaves the backend, for every model endpoint, local ones included. Redaction is a guardrail, not a guarantee.

Stored on your Mac

Chats, documents and memory live on your machine. API keys are stored locally.

You pick the endpoint

Run local models with Ollama, or paste an API key. Prompts go to the endpoint you choose.

Cloak Mode, on by default

Detected keys, passwords, emails and account numbers are swapped for placeholders before a request leaves the backend.

Start with the data boundaryJoeBro stores workspace data on the Mac, but prompts go to the model endpoint the user selects. Cloak Mode replaces detected sensitive values; it does not make hosted inference local or guarantee every sensitive detail is removed. The documented iPhone setup pairs to a Mac that must remain open and awake.
Read more

Articles

Practical notes on where an assistant keeps its memory, what “local” does and does not mean, and how JoeBro works across Mac and iPhone.

Memory & data ownership
AI memory you can find, inspect and edit

A practical look at JoeBro’s separate Mac and phone memory systems: where each lives, how relevant context is selected, and what remains under your control.

App & infrastructure
My personal Raspberry Pi setup for JoeBro

A first-hand account of running JoeBro’s Python and SQLite backend headless on a Pi, with the limits clearly separated from its documented Mac install.