Skip to content

Commit 3bfb0cb

Browse files
waterdrop86claude
andcommitted
docs: update README with Gemini CLI support, accurate MCP tool counts, and version-agnostic download link
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 9a45950 commit 3bfb0cb

1 file changed

Lines changed: 18 additions & 16 deletions

File tree

README.md

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
66
[![CI](https://img.shields.io/github/actions/workflow/status/roman10/mcode/ci.yml?label=CI)](https://github.com/roman10/mcode/actions)
77

8-
mcode is a desktop IDE that lets you run, view, and orchestrate multiple coding-agent sessions simultaneously. It currently supports Claude Code, Codex CLI, and plain terminal sessions. Instead of tabbing between terminals, you see every session at once in a tiling layout — or switch to a kanban board grouped by status. A built-in task queue, hook-driven monitoring for Claude sessions, and 100 MCP tools make it highly automatable.
8+
mcode is a desktop IDE that lets you run, view, and orchestrate multiple coding-agent sessions simultaneously. It currently supports Claude Code, Gemini CLI, Codex CLI, and plain terminal sessions. Instead of tabbing between terminals, you see every session at once in a tiling layout — or switch to a kanban board grouped by status. A built-in task queue, hook-driven monitoring for Claude sessions, and 105 MCP tools make it highly automatable.
99

1010
![Tiling layout with multiple active sessions](docs/screenshots/tiling-layout.png)
1111

@@ -28,7 +28,7 @@ mcode is a desktop IDE that lets you run, view, and orchestrate multiple coding-
2828

2929
- **Task queue** — dispatch prompts to sessions with per-session reordering, retry logic, and concurrent execution.
3030
- **Hook-driven monitoring for Claude** — receives Claude Code hook events (tool use, notifications, permission requests, stops) over HTTP for live session visibility.
31-
- **100 MCP tools**14 tool categories covering sessions, terminals, layout, tasks, git, files, commits, tokens, hooks, and more. Every feature is agent-accessible.
31+
- **105 MCP tools**15 tool categories covering sessions, terminals, layout, tasks, git, files, commits, tokens, hooks, and more. Every feature is agent-accessible.
3232

3333
### Productivity
3434

@@ -44,7 +44,7 @@ mcode is a desktop IDE that lets you run, view, and orchestrate multiple coding-
4444

4545
Pre-built DMG for Apple Silicon (macOS):
4646

47-
**[Download mcode-0.2.0-arm64.dmg](https://github.com/roman10/mcode/releases/latest)**
47+
**[Download latest DMG (Apple Silicon)](https://github.com/roman10/mcode/releases/latest)**
4848

4949
> **Gatekeeper note:** macOS may block the app on first launch since it is not yet notarized. Right-click `mcode.app` in your Applications folder → **Open****Open Anyway**. Alternatively: `xattr -cr /Applications/mcode.app`
5050
@@ -55,6 +55,7 @@ Pre-built DMG for Apple Silicon (macOS):
5555
- **macOS** (primary platform)
5656
- **Node.js** 22 or later
5757
- **Claude Code CLI** installed and authenticated for Claude sessions (`npm install -g @anthropic-ai/claude-code`)
58+
- **Gemini CLI** installed and authenticated for Gemini sessions (`npm install -g @google/gemini-cli`)
5859
- **Codex CLI** installed and authenticated for Codex sessions
5960

6061
### Build from source
@@ -76,7 +77,7 @@ This produces a DMG in the `dist/` directory.
7677

7778
## Quick Start
7879

79-
1. **Create a session** — press <kbd>Cmd+N</kbd>, choose Claude Code or Codex CLI, then pick a working directory and optional prompt.
80+
1. **Create a session** — press <kbd>Cmd+N</kbd>, choose Claude Code, Gemini CLI, or Codex CLI, then pick a working directory and optional prompt.
8081
2. **Split the view** — <kbd>Cmd+D</kbd> splits horizontally, <kbd>Cmd+Shift+D</kbd> splits vertically. <kbd>Cmd+Enter</kbd> maximizes a tile.
8182
3. **Navigate** — <kbd>Cmd+Shift+P</kbd> opens the command palette. <kbd>Cmd+P</kbd> opens Quick Open for file search.
8283
4. **Queue work** — <kbd>Cmd+Shift+T</kbd> creates a task. Tasks dispatch to sessions automatically or can target a specific session.
@@ -103,24 +104,25 @@ See [keyboard shortcuts](docs/user_manual/keyboard-shortcuts.md) for the full li
103104

104105
## MCP Automation
105106

106-
mcode exposes a Model Context Protocol (MCP) server with 100 tools across 14 categories:
107+
mcode exposes a Model Context Protocol (MCP) server with 105 tools across 15 categories:
107108

108109
| Category | Tools | Examples |
109110
|---|---|---|
110-
| Sessions | 14 | create, kill, wait for status, set label, clear attention |
111-
| Terminal | 8 | send keys, read buffer, resize, drop files, wait for content |
112-
| Layout | 11 | get/set view mode, add/remove tiles, toggle command palette |
113-
| Tasks | 5 | create, update, cancel, reorder, wait for status |
111+
| Session | 17 | create, kill, resume, wait for status, set label/model, account list |
112+
| Layout | 15 | get/set view mode, add/remove tiles, toggle command palette |
113+
| Terminal | 9 | send keys, read buffer, resize, drop files, panel height |
114+
| Hooks | 8 | list events, attention summary, wait/clear attention |
115+
| Sidebar | 7 | switch tab, select session, get/set filter |
114116
| Git | 10 | stage/unstage/discard files, get diff, open diff viewer |
115-
| Files | 5 | list, read, write, search, open viewer |
116-
| Commits | 9 | daily stats, heatmap, cadence, streaks, weekly trend |
117+
| Commits | 9 | daily stats, heatmap, cadence, streaks, scan control |
117118
| Tokens | 6 | daily usage, model breakdown, session usage, heatmap |
118-
| Hooks | 4 | list events, inject test events, clear |
119-
| App | 7 | version, console logs, sleep control, detach/reconcile |
119+
| Task | 6 | create, update, cancel, reorder, wait for status |
120+
| File | 5 | list, read, write, search, open viewer |
121+
| App | 5 | version, console logs, HMR events, sleep control |
122+
| Kanban | 3 | get columns, expand session, collapse |
120123
| Window | 3 | get bounds, resize, screenshot |
121-
| Search | 2 | file search, quick open |
122-
| Snippets | 1 | list snippet templates |
123-
| Kanban/Sidebar | 10+ | get columns, select session, switch tab, filter |
124+
| Snippet | 1 | list snippet templates |
125+
| Search | 1 | full-text file search |
124126

125127
This means agents can drive the IDE programmatically — creating sessions, dispatching tasks, reading terminal output, and verifying results without manual interaction.
126128

0 commit comments

Comments
 (0)