monocode README

The project's README from github.com/hardbeat920/monocode. As one markdown file: README.md.

MonoCode

MonoCode

A desktop UI for your coding agents.

Screenshot 2026-09-04 at 06 34 00

Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, OpenCode, Pi, omp, and fx. 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 log in to at least one provider first:

  • Claude Code - claude auth login
  • Codex - codex login
  • Cursor CLI - agent login
  • Grok Build - curl -fsSL https://x.ai/cli/install.sh | bash then grok login
  • OpenCode - opencode auth login
  • Pi - npm install -g @earendil-works/pi-coding-agent
  • omp - curl -fsSL https://omp.sh/install | sh
  • fx - curl -fsSL https://fx.sh/setup.sh | bash then fx login

macOS (Apple Silicon): download MonoCode.dmg, open it, drag MonoCode to Applications.

Linux (x86_64): download the .deb or AppImage from GitHub Releases. Install the .deb with sudo apt install ./MonoCode_*.deb, or make the AppImage executable with chmod +x MonoCode_*.AppImage and run it directly.

Windows (x86_64): download the NSIS installer from GitHub Releases and run it.

Some notes

This is very early and you should expect bugs.

Small, focused pull requests are welcome. Anything large is worth an issue first - see CONTRIBUTING.md.

Build from source

Supports macOS, Linux, and Windows.

Need Node.js 20+ and a current stable Rust toolchain. On Linux, ensure standard Tauri prerequisites are installed (e.g. libwebkit2gtk-4.1-dev, libgtk-3-dev, libsoup-3.0-dev, libjavascriptcoregtk-4.1-dev). On Windows, the installer bootstraps the WebView2 runtime when it is missing.

npm install
npm run tauri dev

Ubuntu / Debian packages

On an Ubuntu/Debian workstation, the repository can install the native Tauri prerequisites and build distributable Linux packages directly:

npm run setup:linux:deb
npm ci
npm run build:linux

The Linux build emits .deb and AppImage bundles under target/release/bundle/. Tauri loads src-tauri/tauri.linux.conf.json automatically for Linux development and builds.

Windows packages

npm ci
npm run build:windows

The Windows build emits an NSIS installer under target/release/bundle/nsis/. Tauri loads src-tauri/tauri.windows.conf.json automatically for Windows development and builds.

License

MIT. Provider names and logos are trademarks of their owners - see NOTICE.

monocode (hardbeat920/monocode)

Searching Database…

3.1K ·GitHub
Monocode
这是什么？MonoCode 是一个面向 Claude Code、Codex、Cursor、Grok Build、OpenCode、Pi、omp、fx 等编程智能体的桌面图形界面。
这是一个新的编程智能体，还是我已有智能体的外壳？它本身不是智能体——而是一个 Tauri 桌面应用，运行你已安装的智能体 CLI，把标签页当作会话，并共用一个输入框。
怎么让它跑起来？先通过其自身的 CLI 登录至少一个受支持的提供商，然后从 GitHub Releases 下载对应的构建：macOS .dmg、Linux .deb/AppImage 或 Windows NSIS 安装包。
它支持哪些编程智能体？需要提前配置好吗？需要——Claude Code、Codex、Cursor CLI、Grok Build、OpenCode、Pi、omp 和 fx 都需要单独安装并登录；MonoCode 只是启动你已经装好的那些。
它稳定到可以日常依赖的程度了吗？还没有——项目明确表示这是非常早期的软件，要有遇到 bug 的心理准备。
它也能在 Intel Mac 上运行吗？macOS 只提供 Apple Silicon 构建；没有提到支持 Intel Mac。
应用里的标签页和输入框到底是什么？标签页是可切换的各个智能体会话，输入框则是唯一的输入位置，你在里面打字，与该标签页中处于活动状态的智能体对话。
MonoCode 为什么不内置自己的 AI 模型？它的设计纯粹是围绕你已单独登录和付费的智能体 CLI 的一层 UI 外壳，因此它自身没有模型，也不涉及 token 计费。
What are similar projects?skills-manager, desktop-cc-gui, opcode, codex-host, qwen-code, zuse, coucou, pi-gui
Which topics is it in?multi-provider, ai-coding, tauri, vite, apple-silicon, cursor, agents, coding-agent, desktop, rust, codex, gui
Creator
hardbeat920
Size
14.1 MB
Stars
3.1K
Updated
CommitOct 16Releasev0.13.0Oct 12
Age
1mo
Commits · 90 Days