An open-source, local-first AI agent desktop client supporting MCP, Skills, ACP agents and remote control from messaging apps.
joexk1/JoeBro
A native macOS AI workspace in SwiftUI that runs locally, with chat, agent tools, email, calendar, memory and document editing.
Open-source alternative to:ChatGPT
- Stars
- 94
- Forks
- 15
- Open issues
- 0
- Last commit
- 4 days ago
What is it?
JoeBro is a native macOS app built with SwiftUI, with a small Python standard-library backend bundled inside it. It launches automatically and serves a local API on 127.0.0.1, so no account or extra install is needed. You bring your own models, either local ones through Ollama or any OpenAI-compatible endpoint, or API keys for hosted providers.
The app combines chat with an agent mode that can read and edit files, run terminal commands, search the web, call custom API tools, and manage email over IMAP and a calendar. Other features include Deep Research with cited reports, Word document editing beside the conversation, Anki flashcard export, a persistent memory store, and an optional iPhone companion that pairs with the Mac over a token-protected connection.
Data such as chats, memory, tasks and documents is stored in a local SQLite database. A Cloak Mode option replaces API keys, passwords and account numbers with placeholders before requests are sent to any model endpoint.
Key features
- 01Chat with local or hosted models, including streaming and switching models mid-conversation.
- 02Agent mode with tools for files, terminal, web search, custom APIs, email and calendar.
- 03Deep Research that produces a cited report from many sources.
- 04Edits Word .doc and .docx documents beside the chat.
- 05Exports study decks as Anki .apkg files.
- 06Local SQLite storage with no telemetry.
- 07Cloak Mode masks secrets before any model request.
Use cases
- Running a private AI assistant on a Mac with local Ollama models.
- Drafting and co-editing Word documents with an AI assistant.
- Triaging email and managing a calendar through a chat interface.
- Generating Anki flashcards from study material.
In collections
Topics
FAQ
- What is JoeBro?
- A native macOS AI workspace in SwiftUI that runs locally, with chat, agent tools, email, calendar, memory and document editing. JoeBro is a native macOS app built with SwiftUI, with a small Python standard-library backend bundled inside it. It launches automatically and serves a local API on 127.0.0.1, so no account or extra install is needed. You bring your own models, either local ones through Ollama or any OpenAI-compatible endpoint, or API keys for hosted providers.
- Is JoeBro free to use? What license does it have?
- JoeBro is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
- Is JoeBro still maintained?
- Actively maintained. The last commit to JoeBro was on Nov 3, 2026.
- What can I use JoeBro for?
- Running a private AI assistant on a Mac with local Ollama models. Drafting and co-editing Word documents with an AI assistant. Triaging email and managing a calendar through a chat interface. Generating Anki flashcards from study material.
- Where can I get JoeBro?
- The source code and installation instructions are on GitHub: https://github.com/joexk1/JoeBro
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted, privacy-first personal AI assistant platform with autonomous agents, 250+ tools, MCP support, and Telegram and WhatsApp connectivity.
A self-hosted Go AI agent that runs 24/7 on your own computer, auto-builds missing tools, and shares them with Claude Code and other agents via MCP.
A native macOS app for chatting with local LLMs served by Ollama, with multiple threads, markdown rendering and vision image support.
A browser-based chat interface for local LLMs served by Ollama, with chats stored in IndexedDB on your own machine.
Browser-based editor for Word, Excel, PowerPoint and PDF files that runs locally, with no Office install or account needed.