{"slug": "a-mac-workspace-where-your-files-and-your-ai-agents-sit-side-by-side", "title": "A Mac workspace where your files and your AI agents sit side by side", "summary": "A developer released JoeBro, a free, open-source GPLv3 Mac workspace that opens documents and code beside a chat window so AI agents such as Claude Code, Codex and OpenCode can read and edit the same files the user works on. The app binds a folder to a workspace, exposes list, read, create and edit file tools inside it, and holds agent edits as pending diffs when a file is open, with chats and per-project memory stored locally in SQLite over MCP with no account or telemetry.", "body_md": "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.\n\n**Short answer:** [JoeBro](https://github.com/joexk1/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.\n\nThe 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.\n\nThree rules, in order of how often they matter:\n\nModels rewrite long files badly in one go. Two practical fixes in the file tools:\n\nThere 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.\n\nClaude 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.\n\nWhether \"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.\n\nJoeBro 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:\n\n```\ncurl -fsSL https://joebro.pages.dev/install.sh | bash\n```\n\nCode: [https://github.com/joexk1/JoeBro](https://github.com/joexk1/JoeBro) . Short answers to common questions: [https://joebro.pages.dev/faq/](https://joebro.pages.dev/faq/)", "url": "https://wpnews.pro/news/a-mac-workspace-where-your-files-and-your-ai-agents-sit-side-by-side", "canonical_source": "https://dev.to/joexk1/a-mac-workspace-where-your-files-and-your-ai-agents-sit-side-by-side-flf", "published_at": "2026-11-22 20:55:25+00:00", "updated_at": "2026-11-22 21:11:35.864306+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "agent-protocols", "ai-products"], "entities": ["JoeBro", "Claude Code", "Codex", "OpenCode", "GitHub", "MCP"], "also_reported_by": [], "takeaway": "JoeBro holds agent edits as pending diffs when a file is open and maps invented parameter names like file, filepath and file_name to path so malformed tool calls don't cost a turn.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/a-mac-workspace-where-your-files-and-your-ai-agents-sit-side-by-side", "markdown": "https://wpnews.pro/news/a-mac-workspace-where-your-files-and-your-ai-agents-sit-side-by-side.md", "text": "https://wpnews.pro/news/a-mac-workspace-where-your-files-and-your-ai-agents-sit-side-by-side.txt", "jsonld": "https://wpnews.pro/news/a-mac-workspace-where-your-files-and-your-ai-agents-sit-side-by-side.jsonld"}}