Most AI tools make you copy text out of a chat window and paste it into the place you actually work. I wanted the opposite: my files open and editable in one window, with the agents working on them right beside me.
Short answer: JoeBro is a free, open-source Mac workspace for your AI agents. Documents and code open next to the conversation, you edit them yourself, and the agents (Claude Code, Codex and OpenCode, plus any model you point it at) read and change the same files. This post is about the design decisions behind the file editing, since "let an AI edit my files" is where most of the risk is.
The editor opens documents beside the chat, so you and the model work on the same text. It handles Markdown with a live outline for jumping around long documents, and it also opens Word .doc and .docx files and spreadsheets. You bind a folder to a workspace, and the agent's file tools (list, read, create, edit) work inside that folder.
Three rules, in order of how often they matter:
Models rewrite long files badly in one go. Two practical fixes in the file tools:
There is also a small alias table for the parameter names that models invent (file, filepath and file_name all mean path; old_string means find), because dropping those calls costs a whole turn.
Claude Code, Codex and OpenCode run in their own terminals. JoeBro shows their sessions in the same window as your files, so you can read what they are doing, answer their permission prompts, and see the files they change, from the Mac or from the iPhone app. They also share one per-project memory over MCP.
Whether "held as a pending diff when the file is open" is the right default for files that aren't open yet. Today those go through the approval prompt where there is one, and I keep going back and forth on whether to open the file in the editor automatically instead.
JoeBro is GPLv3, free and local first: chats and memory live in a SQLite file, with no account and no telemetry. One-line install (macOS 26+), which also plugs it into Claude Code, Codex and OpenCode:
curl -fsSL https://joebro.pages.dev/install.sh | bash
Code: https://github.com/joexk1/JoeBro . Short answers to common questions: https://joebro.pages.dev/faq/