README

Monocode


  A GUI for your coding agents.



  


 [!NOTE]
 Try the new Monocode Native preview, our experimental Rust + GPUI app for macOS, Linux and Windows. Read the preview details before installing.

Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, OpenCode, Antigravity, Pi, omp, fx, Hermes Agent, and Devin. If they’re installed and logged in, MonoCode can run them. Tabs are sessions. The composer is the input. MonoCode does not sell tokens.

 Install

Install and sign in to at least one supported agent first. See provider setup for instructions.

| Platform | Native | Tauri |
| --- | --- | --- |
| macOS, Apple Silicon | MonocodeNative_aarch64.dmg | MonoCode.dmg |
| macOS, Intel | MonocodeNative_x64.dmg | MonoCode_x64.dmg |
| Linux, x86_64 | .deb, .rpm, or AppImage | .deb, .rpm, or AppImage |
| Windows, x86_64 | Installer | Installer |

On macOS, open the DMG and drag MonoCode to Applications. On Windows, run the installer. See Linux setup for dependencies and package instructions.

 Get started

Open a project folder, choose an agent, and send a message. Each tab is a session. Split panes to work with sessions side by side.

- Keep conversations organized by project.
- Use separate Git worktrees for parallel tasks.
- Edit files and review changes in the app.
- Start a message with /operator to let an agent open sessions and manage worktrees and notes.

Monos are experimental agents that work across your projects. They keep a memory and can run scheduled tasks you set up with them.

MonoCode is still early. If something breaks, report a bug.

 Guides

- Provider setup
- Linux installation
- Agent access with /operator
- Remote sessions, experimental

 Build from source

You’ll need Node.js 20+ and a stable Rust toolchain. See build setup for platform dependencies and packaging.

The mobile app is a separate Expo project in mobile/. Run it with cd mobile && npm install && npm start.

bash
npm install
npm run tauri dev


Small, focused contributions are welcome. Read CONTRIBUTING.md before opening a pull request.

 Monocode Native preview

The Rust + GPUI app is an experimental preview. React/Tauri remains the
production app.

Download a packaged preview for macOS, Linux or Windows from the
releases page. See
known limitations before testing.

You can install it alongside MonoCode, but the preview uses your existing
MonoCode database and saves changes there. Back up your data with the app
closed before testing, and avoid editing the same conversations in both apps
at once.

To try GPUI from this checkout with Node.js 22+, Rust and Xcode on macOS:

sh
npm run native:dev      launch with a separate development database
npm run native:build    create an optimized app using installed MonoCode data


Type r then Enter in the development terminal to rebuild and restart; there is
no hot reload. The release app saves changes to your installed MonoCode data.
See the native guide for prerequisites, build output,
checks and previ

Top issues

Discussions

Latest release

Added

- Pair an iPhone from Settings → Connections → Your phones to browse projects and conversations, start and continue sessions, follow streamed replies, stop responses, and view code changes. The iPhone companion is currently an invite-only TestFlight beta.
- Swipe between projects in the new sidebar.
- Project and Inbox actions have keyboard-accessible context menus in the new sidebar.

 Fixed

- The new sidebar keeps Open project and Settings available before a project is selected.
- The empty conversation view no longer scrolls a few pixels around the message input.
- The message input