Gemini CLI on VSCode

🇯🇵 日本語版 | 🇺🇸 English

🔮 MAGUS Council - Unified AI CLI Management

Finally: The Same Claude Code Experience with Gemini CLI & Codex CLI (GPT-5)

💡 Why This Extension is Revolutionary

• ❌ Traditional: Gemini CLI and Codex CLI only run in terminal
• ✅ Innovation: Unified AI management system with editor integration

🔄 Traditional Limitations

• Gemini CLI / Codex CLI: Powerful but only runs in terminal panels
• Gemini Code Assist: Editor integrated but a different tool entirely
• Claude Code: Perfect editor integration but can't use Gemini or GPT-5

✨ This Extension's Innovation

Brings Claude Code's editor integration experience to multiple AI CLIs

• Gemini, Codex, and Qwen run directly in editor windows
• MAGUS Council enables broadcasting single prompts to multiple AI CLIs

⚡ Key Features

🖱️ One-Click Launch

• 4 AI types for batch and individual launch
• Editor title bar icon for instant access
• Command palette integration
• Choose between new pane or active pane

🔧 True Editor Integration

• Opens as an editor tab, not a terminal panel
• Side-by-side with your code files
• Maintains your editor layout

💻 Seamless Workflow

• Keep your code visible while using AI assistance
• No context switching between terminal and editor
• Natural integration with your development flow

🔮 v0.1.0 Major Update - MAGUS Council

• MAGUS Council - Multiple Agent Guidance & Intelligence System 🔮
  • Unified prompt broadcasting: Operate Gemini, Claude, Codex, and Qwen in perfect synchronization
  • All according to the scenario: Optimized execution timing for each AI type

🎨 Other Key Features

• Claude Code Integration: Complete integration of multiple AI CLIs
• Batch Launch: "Launch All CLIs" button starts multiple CLIs simultaneously
• Universal History: Unified history folder .history-memo/ for work logs
• Individual CLI Commands: Dedicated commands for each CLI
• Advanced Settings: Enable/disable CLIs, menu visibility control, etc.

🚀 Quick Start

Prerequisites

# Install Gemini CLI (for Gemini)
npm install -g @google/gemini-cli
gemini  # Google account authentication

# Install Codex CLI (for GPT-5)
npm install -g codex
codex   # OpenAI account authentication

# Install Claude CLI (for Claude)
npm install -g @anthropic-ai/claude-cli
claude  # Anthropic account authentication

# Install Qwen CLI (for Qwen)
npm install -g @qwen-code/qwen-code@latest
qwen    # Qwen account authentication

Usage

1. Open any project in VS Code
2. Click the icon in the editor title bar
   • 🚀 Launch All CLIs - Launch all configured CLIs at once
   • ✨ Launch Gemini CLI
   • ❄️ Launch Codex CLI
   • ✴️ Launch Claude Code
   • 🐉 Launch Qwen Code
3. Launch MAGUS Council
   • MAGUS Council panel appears in sidebar
   • Command Palette: "MAGUS Council: Open"
4. Select desired AIs and send prompts
   • Multiple AI selection enables simultaneous execution

🎨 Customizing Editor Title Bar Buttons

To hide buttons:

• Right-click on any button in the editor title bar
• Uncheck the command from the menu

To show buttons again:

• Right-click on empty space in the editor title bar
• Check the hidden commands in the menu

💡 Tip: Even with buttons hidden, all features remain accessible via Command Palette (Cmd/Ctrl+Shift+P).

Or use Command Palette:

1. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
2. Search for "Gemini CLI" or "Codex CLI"
3. Choose your preferred launch mode

📁 Send Files/Folders to AI CLI

Send from Explorer

• Right-click file or folder
• Select "Gemini CLI: Send File Path" or "Codex CLI: Send File Path"
• Supports multiple selection (Ctrl/Cmd+click)

Send from Editor Tab

• Right-click on editor tab
• Choose your preferred CLI command

Send All Open Files

• Right-click in editor
• Select "Gemini CLI: Send Open File Path" or "Codex CLI: Send Open File Path"

All paths are sent with @ prefix to your selected CLI.

💾 Universal History Save

Save all terminal output to .history-memo/YYYY-MM-DD.md:

From Any Terminal:

• Select text → Click "Save to History" button in status bar
• Works with Gemini CLI, Codex CLI, bash, zsh, Claude Code, and more

Custom Keyboard Shortcut:

• Set your own in VSCode Keyboard Shortcuts settings

📤 Send to AI CLI

Send Selected Text:

• Select text in editor → Right-click
• "Gemini CLI: Send Selected Text" or "Codex CLI: Send Selected Text"

Send File/Folder Paths:

• Right-click in Explorer
• Choose your preferred CLI command
• Supports multiple selection and folders

Send All Open Files:

• Right-click in editor
• Choose "Send Open File Path" for your preferred CLI

🔮 Using MAGUS Council

From Unified Control Panel:

1. Open MAGUS Council panel in sidebar
2. Check desired AIs (Gemini/Claude/Codex)
3. Enter prompt
4. Click "🔮 Ask n AIs" button for batch sending

Individual Control Also Available:

• Direct operation from each AI tab
• Traditional file sending features
• Context menu operations

⌨️ Command Palette

MAGUS Council Commands:

• "MAGUS Council: Open" - Open unified control panel
• "Multi-AI: Ask All" - Batch send to selected AIs

Existing Commands:

• "Launch All CLIs" - Launch multiple CLIs at once (tabs in same group)

Gemini CLI Commands:

• "Gemini CLI: Start in New Pane" - Launch in new pane
• "Gemini CLI: Start in Active Pane" - Launch in active pane
• "Gemini CLI: Send File Path" - Send files/folders
• "Gemini CLI: Send Open File Path" - Send all open files
• "Gemini CLI: Send Selected Text" - Send selected text

Codex CLI Commands:

• "Codex CLI: Start in New Pane" - Launch in new pane
• "Codex CLI: Start in Active Pane" - Launch in active pane
• "Codex CLI: Send File Path" - Send files/folders
• "Codex CLI: Send Open File Path" - Send all open files
• "Codex CLI: Send Selected Text" - Send selected text

Common Commands:

• "Save to History" - Save conversation (works with all terminals)

⌨️ Custom Keyboard Shortcuts

Set your own keybindings:

1. Open Keyboard Shortcuts: Cmd+K Cmd+S (Mac) or Ctrl+K Ctrl+S (Windows/Linux)
2. Search for "Gemini CLI" or "Codex CLI"
3. Click the pencil icon to assign your preferred keys

🆚 Why Choose This Over Alternatives?

🎯 Perfect For

• Developers who love Claude Code's UX but want to use Gemini or GPT-5
• Anyone tired of switching between terminal and editor

📊 Comparison

Feature	This Extension	Gemini Code Assist	Gemini CLI	Codex CLI	Claude Code
Unified AI Management	✅ MAGUS Council	❌	❌	❌	❌
Simultaneous Prompt Sending	✅	❌	❌	❌	❌
Code generation	✅	✅	✅	✅	✅
Runs in editor pane	✅	❌ (sidebar)	❌ (terminal)	❌ (terminal)	✅
Gemini models	✅	✅	✅	❌	❌
OpenAI models	✅	❌	❌	✅	❌
Claude models	✅	❌	❌	❌	✅
Qwen models	✅	❌	❌	❌	❌

⚙️ Configuration Options

Settings are organized in two tiers for better usability:

Standard Settings (Main Configuration)

These are the essential settings most users need:

{
  // Enable/disable AI features
  "gemini-cli-vscode.gemini.enabled": true,
  "gemini-cli-vscode.codex.enabled": true,
  "gemini-cli-vscode.claude.enabled": true,
  "gemini-cli-vscode.qwen.enabled": false
  
  // Core features
  "gemini-cli-vscode.magusCouncil.enabled": true,
  "gemini-cli-vscode.contextMenu.enabled": true,
  "gemini-cli-vscode.saveToHistory.enabled": true
}

Advanced Settings (Fine-tuning)

For power users who want detailed control:

{
  // MAGUS Council configuration
  "gemini-cli-vscode.magusCouncil.defaultAgents": ["gemini", "codex", "claude"],
  "gemini-cli-vscode.magusCouncil.launch.clis": ["claude", "gemini", "codex"],
  "gemini-cli-vscode.magusCouncil.composer.delays.initial": 100,
  
  // Context menu fine-tuning
  "gemini-cli-vscode.contextMenu.showSendText": true,
  "gemini-cli-vscode.contextMenu.showSendFilePath": true,
  "gemini-cli-vscode.gemini.showInContextMenu": true,
  
  // Custom CLI commands (examples)
  "gemini-cli-vscode.gemini.command": "gemini",
  "gemini-cli-vscode.gemini.args": ["--model", "gemini-pro"],
  "gemini-cli-vscode.claude.command": "claude",
  "gemini-cli-vscode.claude.args": [],
  
  // Terminal behavior
  "gemini-cli-vscode.terminal.groupingBehavior": "same",
  "gemini-cli-vscode.terminal.disableFlowControl": true
}

Settings Explained

Standard Settings:

• *.enabled: Enable/disable each AI CLI integration
• magusCouncil.enabled: Enable the unified AI management interface
• contextMenu.enabled: Show AI commands in right-click menus
• saveToHistory.enabled: Enable conversation saving to .history-memo

Advanced Settings:

• magusCouncil.defaultAgents: Pre-selected AIs when opening MAGUS Council
• magusCouncil.launch.clis: Order and selection for "Launch All CLIs"
• contextMenu.show*: Fine-grained control over menu items
• *.command / *.args: Customize CLI launch commands
• terminal.groupingBehavior: How terminals are grouped ("same" or "new")

🛠️ Development

Local Development

git clone https://github.com/d3j/gemini-cli-on-vscode.git
cd gemini-cli-on-vscode
npm install
npm run compile

Debugging

1. Open the project in VS Code
2. Press F5 to launch Extension Development Host
3. Test the extension in the new VS Code window

🐛 Troubleshooting

Common Issues

Q: "gemini: command not found" error

# Solution: Install Gemini CLI
npm install -g @google/gemini-cli

Q: Authentication error

# Solution: Authenticate directly in terminal first
gemini
# Complete browser authentication, then retry extension

Q: Extension not appearing in editor title bar

• Ensure you have an active editor open
• Try reloading VS Code window (Cmd+R / Ctrl+R)

🔧 Output Freezing Prevention

This extension automatically prevents flow control issues when launching Gemini or Codex CLI by applying stty -ixon.

Note: This addresses a known VS Code integrated terminal issue with long, rapid outputs.

🤝 Contributing

Bug reports, feature requests, and pull requests are welcome!

• Bug Reports: Issues
• Feature Requests: Issues
• Pull Requests: Pull Requests

🙏 Acknowledgments

• Gemini CLI by Google
• Claude Code by Anthropic
• VS Code Extension developer community

🎨 Icon Credits

Icons used in this extension are property of their respective owners:

• AllCLIs-icon.png - Irasutoya
• claude-logo.png - Anthropic
• codex-icon.png - OpenAI
• icon.png (Gemini) - Google

※ Company logos are used for identification purposes only. This extension has no official affiliation with these companies.

---

📈 If You Like This Extension

⭐ Please star on GitHub! 🐛 Report any bugs you find 💡 Share your feature ideas 📢 Share with your team

⭐ Star on GitHub | 🐛 Report Bug | 💡 Request Feature

📄 License

MIT License - See LICENSE file for details

👤 Author

Joji Jorge Senda (@d3j)