Projects, chats, notes and a whole company of agents, built around the agent CLIs you already pay for: Claude Code, Codex, Antigravity and GitHub Copilot. Everything stays on your Mac. Your iPhone and iPad drive it over your network, or through your own iCloud when you're away.
Not released yet: the redesigned app has no signed download. Build it from source below, and see
the launch checklist for what stands between here and a .dmg.
xBot is a native Mac app for working with AI agents. Add any folder as a project and talk to an agent about it in chats that sit as tabs in the title bar. Replies stream in as they're written, each tool the agent uses folds into one line, and a Plan mode has the agent propose steps you can edit before it runs them one by one. Beside the chat, the inspector shows the project's git changes (commit, sync, pull requests and their checks) and its files. Each chat has its own terminal window. Notes live as Markdown in the project folder, and Automations run agent steps on a schedule, even while xBot is closed.
The agents are a crew: personas with a name, a role, instructions and a pixel-art look, each working through one of your CLIs. They're organised like a company. HeadMaster is the CEO and reports to you; a CTO or CFO reports to HeadMaster; engineers report to the CTO, and so on. You decide who reports to whom, and xBot suggests what most companies do. Managers hand work to their team, and finished work reports back up. On the Agents page the crew lives in a little MapleStory-style world (a village, a sky realm, an underwater kingdom, a moonbase or an enchanted forest) where they stroll, sit down at a desk to work and say what they're doing.
Underneath, there are no services. xBot starts the CLI for one turn at a time in the project's folder, feeds it the prompt and reads its stream; the CLI's own sign-in, subscription and permissions are used. Projects, chats and the crew are kept in one SQLite file on the Mac. The iPhone and iPad app is a remote for that Mac: pair it with a QR code, and it reaches the Mac directly on the same network or, away from home, through your own iCloud, with everything sealed by the pairing key. It has the Mac's features (chats, projects and files, notes, automations, the crew and their world, abilities, a real terminal, your profile and usage) in a Liquid Glass interface.
You never open a terminal to use it. You never edit a configuration file. You never read a log.
xBot 1.0 ran OpenBot's agent platform in Docker on the Mac. It worked, and it was heavy: a container runtime to install, an image to pull, a database to migrate, and an agent loop that duplicated the ones people already pay for.
MonoCode showed a lighter shape: a desktop app that drives the agent CLIs people already have and puts projects, chat tabs, notes and personas around them. xBot was rebuilt in that shape, natively in Swift (ADR-0009), and went further: a crew organised as a company, a world to watch them in, and a phone that runs it all from anywhere.
In development. The redesigned Mac app is merged up to Automations (PRs #18–#29), and its CI passes. The iPhone and iPad app and the company org chart are in a stack of open pull requests (#31–#42), each built test-first, verified live against a real Mac, and installed on a real iPhone. There are 443 package tests, plus 18 live phone tests that run against a debug Mac.
Not built yet: a native agent loop for API keys and Ollama, a computer of its own for an agent (a Linux VM on Apple's Containerization), and a signed 2.0 release. The last published release, 1.0.0, is the old Docker app.
Start at docs/README.md. What's done and what's next is in
docs/12-roadmap.md.
scripts/generate-app-icon.sh # once per clone: compile xBot.icon (needs Xcode 26)
cd apps/mac && swift run # the Mac app, debug build
cd apps/mac && swift build --build-tests && swift test # 443 tests; plain `swift build` skips the test targets
XBOT_LIVE_HARNESS=1 swift test --filter LiveHarnessTests # opt-in: real turns against the CLIs you have
cd apps/ios && xcodegen generate # the iPhone/iPad project, from project.yml
xcodebuild -project apps/ios/XBotMobile.xcodeproj -scheme XBotMobile \
-destination 'generic/platform=iOS Simulator' -skipPackagePluginValidation build # build for the simulatorRequires macOS 26 on Apple silicon and Xcode 26, plus at least one agent CLI installed and signed
in (Claude Code, Codex, Antigravity's agy or GitHub Copilot's copilot); xBot finds them on
your login shell's PATH. swift build fails with "missing inputs" until generate-app-icon.sh
has run. The phone's away-from-home lane needs the Mac app signed with the iCloud entitlement: see
packaging. Running the iPhone app on a device needs your own
Apple Developer team in apps/ios/project.yml.
| Documentation index | Reading order, conventions and every spec |
| Vision | What xBot is, for whom, and what it is not |
| Architecture | What runs, how a message becomes a reply, storage, the remote |
| Agents and providers | The four agent CLIs: how each is run, models, reasoning, usage |
| The Mac app | Modules, ownership and tests |
| First run | What happens the first time, on the Mac and the phone |
| Design system | Tokens, motion, materials, worlds, the phone's look |
| UI specification | Every screen of the Mac app and the iPhone/iPad app |
| Security | What xBot can do on your Mac, keys, pairing, the remote lanes |
| Packaging and updates | Building, signing, Sparkle, installing on a device |
| Roadmap | What's done, what's open, what's next |
| Launch checklist | What is left before a public 2.0, in order |
| The iPhone and iPad app | The remote: lanes, pairing, protocol, features, tests |
| Decisions | ADRs 0001–0009. 0009 supersedes the 1.x engine decisions |
| Design specs | One spec per sub-project, from the redesign onward |
| Plans | Step-by-step plans for the larger sub-projects |
| Changelog | What changed since 1.0.0 |
App updates use Sparkle (MIT), and the terminals use
SwiftTerm (MIT). The design follows
MonoCode (MIT); xBot contains none of its code. xBot 1.x
was built on OpenBot by CopilotKit
(MIT); no OpenBot code ships any more. See NOTICE.
xBot is not affiliated with, endorsed by, or sponsored by MonoCode, CopilotKit, Anthropic, OpenAI, Google, GitHub, xAI or any other model provider. Their product names identify the tools you can connect.
MIT. See LICENSE.