Gemini Command Center

Gemini Command Center is a robust Electron-based graphical user interface (GUI) and Node.js backend integration that serves as a bridge for the Gemini CLI operating in Agent Control Protocol (ACP) mode. This application allows users to seamlessly interact with Gemini models (e.g., Gemini 3 Flash and Gemini 3.1 Pro) while leveraging the Model Context Protocol (MCP) to extend AI capabilities with external tools.

Features

• Electron GUI: A modern React-based user interface built with Vite and Tailwind CSS.
• Node.js RPC Backend: Facilitates robust communication with the Gemini CLI via JSON-RPC, parsing stdout and managing agent sessions.
• Intelligent Routing: Automatically routes prompts to the appropriate model tier (Flash for simple tasks, Pro for complex orchestration) based on your prompt's requirements.
• Model Context Protocol (MCP) Support: Hooks into MCP servers to provide the Gemini models with tools and context, supercharging your local AI experience.
• Context Compression: Automatically manages token usage thresholds to prevent blowing past context window limitations while preserving essential chat history.
• Real-Time Streaming: Real-time websocket-powered responses via Socket.IO.

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• The Gemini CLI installed locally and accessible.
• API Key from Google AI Studio (GEMINI_API_KEY or GOOGLE_API_KEY)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/gemini-cli-ui.git
   cd gemini-cli-ui

2. Install dependencies for the root and frontend:

   npm install
   cd frontend
   npm install
   cd ..

3. Configure environment variables: Create a .env file in the root directory.

   GEMINI_API_KEY=your_api_key_here

Running the App

You can run the backend and frontend simultaneously:

Start the Backend

npm run start:backend

Start the Frontend

npm run start:frontend

Architecture

• Backend: Express + Socket.IO server. Spawns the Gemini CLI child process using --acp, handles standard I/O communication, coordinates tool execution, and manages sessions.
• Frontend: Vite + React + Electron application. Provides the visual interface for chat, tool inspection, and agent session tracking.

License

This project is licensed under the MIT License with a Commons Clause condition. This means you have the freedom to view, modify, and use the software, but you may not sell the software or provide it as a commercial hosted service. See the LICENSE file for more details.