Skip to content

Commit d06b972

Browse files
authored
Merge pull request #36 from shinpr/docs/update-readme-for-gemini
docs: Add Gemini CLI support to README
2 parents 2a042ce + 02adce0 commit d06b972

File tree

1 file changed

+22
-6
lines changed

1 file changed

+22
-6
lines changed

README.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
Bring Claude Code–style sub-agents to any MCP-compatible tool.
77

8-
This MCP server lets you define task-specific AI agents (like "test-writer" or "code-reviewer") in markdown files, and execute them via Cursor CLI or Claude Code CLI backends.
8+
This MCP server lets you define task-specific AI agents (like "test-writer" or "code-reviewer") in markdown files, and execute them via Cursor CLI, Claude Code CLI, or Gemini CLI backends.
99

1010
## Why?
1111

@@ -14,7 +14,7 @@ Claude Code offers powerful sub-agent workflows—but they're limited to its own
1414
**Concrete benefits:**
1515
- Define reusable agents once, use them across multiple tools
1616
- Share agent definitions within teams regardless of IDE choice
17-
- Leverage Cursor CLI or Claude Code CLI capabilities from any MCP client
17+
- Leverage Cursor CLI, Claude Code CLI, or Gemini CLI capabilities from any MCP client
1818

1919
[Read the full story](https://dev.to/shinpr/bringing-claude-codes-sub-agents-to-any-mcp-compatible-tool-1hb9)
2020

@@ -36,6 +36,7 @@ Claude Code offers powerful sub-agent workflows—but they're limited to its own
3636
- One of these execution engines (they actually run the sub-agents):
3737
- `cursor-agent` CLI (from Cursor)
3838
- `claude` CLI (from Claude Code)
39+
- `gemini` CLI (from Gemini CLI)
3940
- An MCP-compatible tool (Cursor IDE, Claude Desktop, Windsurf, etc.)
4041

4142
## Quick Start
@@ -78,6 +79,17 @@ npm install -g @anthropic-ai/claude-code
7879

7980
Note: Claude Code installs the `claude` CLI command.
8081

82+
**For Gemini CLI users:**
83+
```bash
84+
# Install Gemini CLI
85+
npm install -g @google/gemini-cli
86+
87+
# Authenticate via browser (required before first use)
88+
gemini
89+
```
90+
91+
Note: Gemini CLI uses OAuth authentication. Run `gemini` once to authenticate via browser.
92+
8193
### 3. Configure MCP
8294

8395
Add this to your MCP configuration file:
@@ -93,7 +105,7 @@ Add this to your MCP configuration file:
93105
"args": ["-y", "sub-agents-mcp"],
94106
"env": {
95107
"AGENTS_DIR": "/absolute/path/to/your/agents-folder",
96-
"AGENT_TYPE": "cursor" // or "claude"
108+
"AGENT_TYPE": "cursor" // or "claude" or "gemini"
97109
}
98110
}
99111
}
@@ -120,6 +132,9 @@ Sub-agents may fail to execute shell commands with permission errors. This happe
120132

121133
# For Claude Code users
122134
claude
135+
136+
# For Gemini CLI users
137+
gemini
123138
```
124139

125140
2. When prompted to allow commands (e.g., "Add Shell(cd), Shell(make) to allowlist?"), approve them
@@ -212,6 +227,7 @@ Path to your agents folder. Must be absolute.
212227
Which execution engine to use:
213228
- `"cursor"` - uses `cursor-agent` CLI
214229
- `"claude"` - uses `claude` CLI
230+
- `"gemini"` - uses `gemini` CLI
215231

216232
### Optional Settings
217233

@@ -335,7 +351,7 @@ Check that:
335351

336352
### Other execution errors
337353

338-
1. Verify `AGENT_TYPE` is set correctly (`cursor` or `claude`)
354+
1. Verify `AGENT_TYPE` is set correctly (`cursor`, `claude`, or `gemini`)
339355
2. Ensure your chosen CLI tool is installed and accessible
340356
3. Double-check that all environment variables are set in the MCP config
341357

@@ -364,14 +380,14 @@ The startup overhead is an intentional trade-off: the system favors clarity and
364380

365381
## How It Works
366382

367-
This MCP server acts as a bridge between your AI tool and a supported execution engine (Cursor CLI or Claude Code CLI).
383+
This MCP server acts as a bridge between your AI tool and a supported execution engine (Cursor CLI, Claude Code CLI, or Gemini CLI).
368384

369385
**The flow:**
370386

371387
1. You configure the MCP server in your client (Cursor, Claude Desktop, etc.)
372388
2. The client automatically launches `sub-agents-mcp` as a background process when it starts
373389
3. When your main AI assistant needs a sub-agent, it makes an MCP tool call
374-
4. The MCP server reads the agent definition (markdown file) and invokes the selected CLI (`cursor-agent` or `claude`)
390+
4. The MCP server reads the agent definition (markdown file) and invokes the selected CLI (`cursor-agent`, `claude`, or `gemini`)
375391
5. The execution engine runs the agent and streams results back through the MCP server
376392
6. Your main assistant receives the results and continues working
377393

0 commit comments

Comments
 (0)