🤖 AI CLI Manager

Your Central Hub for AI Coding Assistants on Windows & Linux.

Overview

AI CLI Manager (v1.2.27) is a powerful command-line utility designed to simplify the installation, management, and launching of various AI coding assistants. It bridges the gap between different AI tools, providing a unified interface and seamless Windows integration.

---

✨ Key Features

• Unified Launcher: Launch any supported AI CLI (Gemini, Claude, Copilot, etc.) with a single keystroke.
• 🔥 CLI Beast Mode: Launch up to 4 AI CLIs simultaneously in a perfectly aligned 2x2 grid (Windows Terminal or tmux).
• Smart Installation: Automated dependency checks (Node.js, Python, Git, curl) and one-click installs for missing tools.
• Pre-Launch Validation: Verifies a CLI is actually installed before attempting to launch — clear error messages guide you to fix it.
• Windows Integration: Add a cascading "Open with AI CLI" menu to your right-click context menu in File Explorer.
• Cross-Platform: Primary focus on Windows (Batch) with robust support for Linux & macOS (Shell).
• Session Awareness: Comprehensive logging and registry backup utilities for system safety.

---

🚀 Quick Start

💻 Windows (Primary)

1. Run: Double-click AI_CLI_Manager.bat.
2. Elevate: The script automatically requests Administrator privileges for system integrations.
3. Terminal: Automatically detects Windows Terminal; falls back to standard CMD if needed.

🐧 Linux & macOS

1. Permission: chmod +x AI_CLI_Manager.sh Multi_CLI_Grid.sh
2. Run: ./AI_CLI_Manager.sh
3. See LINUX_MAC_README.md for platform-specific details.

---

🔥 CLI Beast Mode (Grid View)

Beast Mode is for power users who need to orchestrate multiple AI agents at once. It launches 4 CLIs in a single session, split into quadrants.

🚀 How to Launch

• Windows: Run Multi_CLI_Grid.bat (Requires Windows Terminal).
• Linux/Mac: Run ./Multi_CLI_Grid.sh (Requires tmux).

🛠️ Configuration

1. Select Layout: Choose from Preset Alpha (Copilot/Codex/Qoder/Antigravity), Preset Beta (KiloCode/Vibe/OpenCode/Qwen), or Custom Pick.
2. Select Directory: Enter the path to your project folder when prompted.
3. Go!: The grid opens instantly in that directory.

Note: Beast Mode supports all 19 tools (options 1–19), matching the main manager menu.

Tip: In tmux (Linux/Mac), use Ctrl+B then D to detach from the grid without killing your active AI sessions.

---

📋 Supported Tools

The manager supports a wide range of industry-leading AI models and CLI agents:

Tool	Package	Command	Installation
Gemini (Deprecated)	@google/gemini-cli	gemini	NPM
Jules	@google/jules	jules	NPM
Claude	Official Script	claude	PowerShell / Curl
OpenAI Codex	@openai/codex	codex	NPM
Mistral Vibe	mistral-vibe	vibe	PIP (Python)
GitHub Copilot	@github/copilot	copilot	NPM
Qwen Code	@qwen-code/qwen-code	qwen	NPM
Cline	cline	cline	NPM
iFlow (Deprecated)	@iflow-ai/iflow-cli	iflow	NPM
OpenCode	opencode-ai	opencode	NPM
KiloCode	@kilocode/cli	kilocode	NPM
NanoCode	nanocode-agent	nanocode	Git + Link
Junie	Official Script	junie	PowerShell / Curl
Kiro	Official Script	kiro-cli	Bash / Curl (Unix only*)
Qoder	@qoder-ai/qodercli	qodercli	NPM
Antigravity	Official Script	agy	PowerShell / Curl
Aider	aider-chat	aider	PIP (Python)
Open Interpreter	open-interpreter	interpreter	PIP (Python)

Note on Installation: Smart Install (Option I) automatically manages Node.js, Python, and Git. Git-based tools like NanoCode are cloned into the /Tools directory and linked via npm link.

*Note on Kiro CLI: This tool is not natively supported on Windows. Use WSL or Git Bash for access.

---

🛠️ Menu Guide

1. Management & Versions

• I Check and Install All: Scans for all supported tools and installs missing ones automatically.
• V Show Versions: Lists specific installed versions or marks them as [NOT INSTALLED].

2. Launch CLIs (1-19)

Launches the selected tool in the current directory (or a specified path) using the best available terminal emulator.

3. Context Menu Integration

• A Add to Windows Context Menu: (Pro-Tip 🔥) Adds a right-click "Open with AI CLI" menu to Explorer.
  • How to use: Right-click any folder or empty space > Hover over "Open with AI CLI" > Select your agent.
• B Remove Menu: Cleanly uninstalls registry entries.
• C Registry Backup: Highly Recommended before using Option A. Saves a .reg file to the Log Files folder.

4. System Utilities

• D Restart Explorer: Instantly applies visual/registry changes.
• E Deep Refresh Icons: Force-clears icon cache if menu icons look broken.

---

🐧 Testing Linux Scripts on Windows

You can run AI_CLI_Manager.sh on Windows for cross-platform testing:

• Option 1: Git Bash: Right-click folder > "Open Git Bash Here" > ./AI_CLI_Manager.sh.
• Option 2: WSL (Recommended): Navigate to your project folder (e.g., /mnt/c/Users/...) in your WSL terminal for a true Linux environment.

---

🔍 Troubleshooting & Logs

Issue	Solution
"Access Denied"	Right-click > "Run as Administrator".
Menu not appearing	Use Option D (Restart Explorer).
Broken Icons	Use Option E (Deep Refresh).
PATH errors	Restart your computer after new tool installations.
"CLI not found in PATH"	Run Option I to install the missing tool, then retry.
Junie/Kiro install fails	Ensure curl (Linux/macOS) or internet access (Windows) is available.
Context menu icons persist after removal	Use Option E (Deep Refresh Icons) after removing the menu.

• Logs: AI_CLI_MG_YYYYMMDD_HHMMSS.log in Log Files/.
• Backups: AI_CLI_Backup_YYYYMMDD_HHMMSS.reg in Log Files/.

---

📊 Project Visual Overview

📚 Documentation Links

• 🛠️ Technical Documentation: Deep dive into architecture and logic.
• 🎨 Design Philosophy: The "Why" behind the tool.
• 🤝 Contributing Guide: How to help improve the tool.
• 🐧 Linux & macOS Guide: Platform-specific details.

---

⚖️ License & Credits

Licensed under the GNU General Public License v3.

Copyright (C) 2026 Krishna Kanth B