The Unified Command Center for AI-Powered Development.
AI CLI Hub is a lightweight, high-performance VS Code extension designed to centralize and simplify your interaction with terminal-based AI agents. Whether you use Gemini, Claude, or GitHub Copilot CLI, this extension provides a seamless, one-click interface to manage, provision, and launch them instantly.
🚀 Key Value Proposition
Stop context-switching and wrestling with terminal flags. AI CLI Hub turns your favorite command-line AI tools into interactive, first-class citizens of your VS Code workspace.
Sidebar: Click the Terminal Icon in the Activity Bar to manage your workspace.
Status Bar: Click the permanent "AI CLI" button at the very bottom right.
Keyboard: Press Cmd + Option + A (Mac) or Ctrl + Alt + A (Windows/Linux) to search and launch agents in seconds.
⚡ Core Features
1. Unified Agent Registry
Curated Directory: Quick access to industry leaders like Gemini, Claude, and GitHub Copilot.
Custom CLI Support: Manually register any proprietary or custom-built CLI tool with ease.
2. Intelligent Provisioning
Environment Detection: Automatically detects if an agent is installed in your system PATH.
One-Click Setup: Provision missing agents (via npm, pip, gh, etc.) directly from the sidebar.
3. Dynamic Terminal Management
Single-Click (Focus): Re-use or focus an existing terminal session to keep your workspace clutter-free.
Integrated Session: Sessions run directly in your native VS Code terminal with safe pre-flight checks.
4. High-Velocity Access
Sidebar Explorer: A dedicated, native-feeling tree view for full agent management.
Status Bar Quick-Launch: A high-visibility button for immediate agent selection.
Global Keybinding:Cmd + Option + A (Mac) or Ctrl + Alt + A (Win/Linux) for searchable agent launching.
🖱️ Interaction Guide
Action
Sidebar / Status Bar Result
Left Click
Launch/Focus existing agent session.
Add Agent (+)
Browse the registry or configure a custom CLI.
Right Click
Remove agent configuration from workspace.
📂 Modular Architecture
The extension is built with a clean, scalable structure:
src/models/: Core data schemas for Agent configurations.
src/services/: Logic for Terminal Management, Configuration, and Environment checks.
src/providers/: Native VS Code UI components and Tree Data Providers.
src/ui/: Interactive user flows and registry definitions.
📦 Getting Started
Installation
Search for "AI CLI Hub" in the VS Code Marketplace.
Click Install.
Open the Terminal Icon in the Activity Bar to begin.
Adding Your First Agent
Click the + icon in the AI CLI sidebar.
Select an agent from the registry (e.g., Gemini CLI).
Click Add to Hub.
If the tool is missing, click the Download Icon to provision it automatically.
🛡️ Privacy & Reliability
Local First: Your API keys and data stay within your CLI tools. We never intercept or store your responses.
Safe Execution: Uses background environment checks to ensure commands are ready before execution.
Crafted for developers who live in the terminal but work in the IDE. 💻✨
