AI Cli Hub
Run ClaudeCode, OpenCode, Gemini and other AI CLI tools directly in VSCode.
English | 简体中文
Features
- Status Bar Icons: Quick access to Claude, Opencode, Codex, Gemini, Copilot and more from the status bar
- Quick Commands: Execute AI CLI tools instantly with one click
- Custom Commands: Configure your own commands via settings
- Context Menu: Send selected code to AI tools directly from editor
- Configurable: Choose which icons to show, icon style, and terminal location
Status Bar
Click any icon in the status bar to execute the corresponding command:
| Icon |
Command |
Description |
| 🤖 Claude |
Quick Claude |
Executes Claude CLI in a new terminal |
| 💻 Opencode |
Quick Opencode |
Executes Opencode CLI in a new terminal |
| ⚗️ Codex |
Quick Codex |
Executes Codex CLI in a new terminal |
| ✨ Gemini |
Quick Gemini |
Executes Gemini CLI in a new terminal |
| 🐙 Copilot |
Quick Copilot |
Executes Copilot CLI in a new terminal |
Requirements
- Claude CLI (optional): For the Quick Claude feature
- Opencode CLI (optional): For the Quick Opencode feature
- Codex CLI (optional): For the Quick Codex feature
- Gemini CLI (optional): For the Quick Gemini feature
- Copilot CLI (optional): For the Quick Copilot feature
Usage
Status Bar Icons
Click any icon in the VS Code status bar (right side) to execute the corresponding command.
Keyboard Shortcuts
| Shortcut |
Command |
Description |
Cmd+Shift+C |
Quick Claude |
Execute Claude CLI |
Cmd+Shift+O |
Quick Opencode |
Execute Opencode CLI |
Note: Shortcuts work when the editor has focus. You can customize them in VS Code Keyboard Settings.
Command Palette
You can also use the Command Palette (Cmd+Shift+P):
- Search for "AI Cli Hub: Quick Claude"
- Search for "AI Cli Hub: Quick Opencode"
- Search for "AI Cli Hub: Quick Codex"
- Search for "AI Cli Hub: Quick Gemini"
- Search for "AI Cli Hub: Quick Copilot"
Extension Settings
Status Bar Visibility
Control which icons appear in the status bar:
| Setting |
Type |
Default |
Description |
aiCliHub.showWarpIcon |
boolean |
false |
Show Warp icon in status bar |
aiCliHub.showClaudeIcon |
boolean |
true |
Show Claude icon in status bar |
aiCliHub.showOpencodeIcon |
boolean |
true |
Show Opencode icon in status bar |
aiCliHub.showCodexIcon |
boolean |
true |
Show Codex icon in status bar |
aiCliHub.showGeminiIcon |
boolean |
false |
Show Gemini icon in status bar |
aiCliHub.showCopilotIcon |
boolean |
false |
Show Copilot icon in status bar |
Example: Hide Opencode icon
{
"aiCliHub.showOpencodeIcon": false
}
Icon Style
Choose how icons are displayed:
| Setting |
Type |
Default |
Options |
aiCliHub.iconStyle |
string |
"icon+text" |
"icon" or "icon+text" |
Example: Show only icons (no text)
{
"aiCliHub.iconStyle": "icon"
}
Terminal Location
Choose where terminals open when executing commands:
| Setting |
Type |
Default |
Options |
aiCliHub.terminalLocation |
string |
"editor" |
"panel" (bottom) or "editor" (as tab) |
Example: Open terminals in bottom panel
{
"aiCliHub.terminalLocation": "panel"
}
CLI Commands
Customize the commands executed by each tool:
| Setting |
Type |
Default |
Description |
aiCliHub.claudeCommand |
string |
claude --dangerously-skip-permissions |
Command for Claude icon |
aiCliHub.opencodeCommand |
string |
opencode |
Command for Opencode icon |
aiCliHub.codexCommand |
string |
codex -c model_reasoning_effort="high" ... |
Command for Codex icon |
aiCliHub.geminiCommand |
string |
gemini --yolo |
Command for Gemini icon |
aiCliHub.copilotCommand |
string |
copilot --allow-all |
Command for Copilot icon |
Custom Commands
Add your own commands to the status bar by configuring aiCliHub.customCommands:
Example Configuration
{
"aiCliHub.customCommands": [
{
"name": "Aider",
"command": "aider --model claude",
"icon": "$(sparkle)"
},
{
"name": "Run Tests",
"command": "npm test",
"icon": "$(beaker)"
},
{
"name": "Git Status",
"command": "git status",
"icon": "$(source-control)"
}
]
}
Configuration Schema
| Property |
Type |
Required |
Description |
name |
string |
Yes |
Display name shown in status bar |
command |
string |
Yes |
The terminal command to execute |
icon |
string |
No |
Status bar icon (VS Code Codicon format, e.g., $(robot)) |
Send selected code to AI tools directly from the editor right-click menu.
| Setting |
Type |
Default |
Description |
aiCliHub.contextMenuEnabled |
boolean |
true |
Enable editor context menu |
aiCliHub.contextMenuShowOnlySelected |
boolean |
false |
Show menu only when text is selected |
aiCliHub.contextMenuMaxSelectionLength |
number |
10000 |
Max selection length (characters) |
Complete Settings Example
{
// Status bar visibility
"aiCliHub.showClaudeIcon": true,
"aiCliHub.showOpencodeIcon": true,
"aiCliHub.showCodexIcon": true,
"aiCliHub.showGeminiIcon": false,
"aiCliHub.showCopilotIcon": false,
// Show only icons, no text
"aiCliHub.iconStyle": "icon",
// Open terminals as editor tabs
"aiCliHub.terminalLocation": "editor",
// Custom CLI commands
"aiCliHub.claudeCommand": "claude --model opus",
"aiCliHub.opencodeCommand": "opencode",
// Custom commands
"aiCliHub.customCommands": [
{
"name": "Aider",
"command": "aider --model claude",
"icon": "$(sparkle)"
}
]
}
Known Issues
- CLI tools must be installed and in your PATH for respective features to work
- Configuration changes take effect immediately (hot reload supported)
Release Notes
See CHANGELOG.md for release history.
Development
# Install dependencies
pnpm install
# Compile
pnpm run compile
# Watch for changes
pnpm run watch
# Run tests
pnpm run test
License
MIT
Enjoy!
