{"id":"46c94b50-ac48-4303-a4f5-1e3fe6024fec","slug":"cli-agents-hq","kind":"skill","name":"CLI-Agents-HQ","summary":"An interactive orchestration dashboard for managing multiple Gemini CLI agents connected directly to your local machine.","owner":"DamiansLab","repoUrl":"https://github.com/DamiansLab/CLI-Agents-HQ","license":"GPL-3.0","licenseTier":"strong-copyleft","trust":"community","stars":7,"match":null,"fewStars":false,"format":"skill","createdAt":"2026-04-21T12:40:31.000Z","addedAt":"2026-10-21T10:56:03.928Z","logoUrl":"https://avatars.githubusercontent.com/u/20972973?u=b3ad035fa6c6568075b4e9c217650a5fdfb51846&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["data-analytics"],"tags":["agents","ai-tools","gemini","gemini-cli"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-21T13:57:12.254Z","sample":false,"url":"https://conduits.dev/tools/cli-agents-hq","language":"TypeScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"
\n \n
\n\n# 🤖 CLI Agents HQ\n### Secure, Multi-Agent Orchestration & Hybrid AI Dashboard\n\nCLI Agents HQ is a professional management hub for your Gemini CLI agents. It transforms individual terminal interactions into a cohesive, team-based environment, allowing you to coordinate multiple AI specialists from a single, centralized command center.\n\n---\n\n## 🏛️ System Architecture\n\n```mermaid\ngraph TD\n subgraph Local Environment\n T[Terminal] -->|CLI Commands| W(Local Worker)\n W -->|Reads/Writes| F[(Local Files/Project)]\n end\n \n subgraph Cloud Dashboard\n D{Next.js Admin Panel}\n D -->|WebSockets| S(Socket.io Server)\n end\n \n W <==>|Secure Bi-directional Sync| S\n S -->|Real-time UI| D\n \n classDef default fill:#0A0A0B,stroke:#F18E45,stroke-width:1px,color:#f1f1f1;\n classDef highlight fill:#F18E45,stroke:#fff,stroke-width:0px,color:#0a0a0b;\n class D highlight\n```\n\n---\n\n\n\n\n## 🎯 What the app does\nCLI Agents HQ bridges the gap between powerful AI execution and intuitive team management. It allows you to:\n- **Orchestrate specialized teams:** \"Hire\" multiple agents and assign them expert roles (Architect, Security Auditor, Test Engineer, etc.) from a library of custom skills.\n- **Hybrid Local Execution:** Securely connect your local terminal to an online dashboard. Your agents have full access to your local project files, while their progress and \"Lessons Learned\" are synced to the cloud.\n- **Session Persistence (New):** Never lose a conversation. Full chat histories are now persisted on the server, allowing you to resume tasks even after a network disconnect.\n- **Multi-Worker Routing (New):** Scale your team across multiple physical machines. The HQ now supports multiple concurrent local workers with sticky routing.\n- **Stall & Health Monitoring:** Real-time heartbeat detection alerts you if an agent process hangs or takes too long to respond.\n- **Knowledge Search:** Efficiently filter through your Knowledge Vault with a new server-side search engine.\n- **Collaborative Brainstorming:** Use the **Conference Room** to start group chats where specialists build upon each other's ideas to solve complex problems.\n- **Unified Knowledge:** Feed a global **Project Brief** or specific **Knowledge Vault** snippets to your entire team simultaneously.\n- **Persistent Evolution:** Agents gain XP and level up from Junior to Senior as they \"Reflect & Learn\" from your conversations. Their insights are now extracted via structured JSON and synced using **MD5 Content Hashing** for maximum reliability.\n- **Windows Optimized:** Deep integration for Windows terminal encoding (UTF-8) and multi-nested process handling.\n\n\n\n\n\n\n---\n\n## 🚀 How to Connect & Use\n\n### 💾 Persistence Note (Updates)\nWhen updating your HQ to a new version, **always preserve your `data.json` and `users.json` files** on the server. These files contain your agents' XP, levels, knowledge vault, and user accounts. If you are using the `prepare-deploy.js` script, ensure you download the live versions of these files to your local root before building, or exclude them from your server upload.\n\n### 🔐 Default Login Credentials\nUpon first deployment, use these credentials to access the dashboard:\n- **Username:** `Admin`\n- **Password:** `admin123`\n- *⚠️ IMPORTANT: Change your password in the **👥 USERS** menu immediately after logging in.*\n\n### 🛠️ Development & Testing\nThe project now includes a formal test suite to ensure architectural integrity.\n```bash\nnpm install\nnpm test\n```\n\n### 1. Deploy the HQ (Server)\n1. Upload the `deploy-ready` folder to your Plesk server.\n2. In Plesk Node.js settings, set `entry.js` as the startup file.\n3. **Configuration:** You can set Environment Variables in Plesk or create a `.env` file in the root:\n - `CLI_AGENTS_SECRET_KEY`: A strong secret for the local machine \"handshake\".\n - `JWT_SECRET`: A random string used to secure user login sessions.\n - `PORT`: (Optional) The port the server will run on (default: 5500).\n4. Run **NPM Install** and **Restart**.\n\n### 2. Connect the Engine (Local)\nYou can use the pre-bundled **CLI Agents HQ Local** folder, or set it up manually.\n\n**Using .env (New & Recommended)**\n1. Create a `.env` file in your local folder (see `.env.example`).\n2. Add your `SERVER_URL` and `CLI_AGENTS_SECRET_KEY`.\n3. Run `node agent.js` to connect instantly.\n\n**Option A: Automated (Legacy)**\n1. Copy the `CLI Agents HQ Local` folder to your computer.\n2. Run `npm install` and `node agent.js`.\n3. Follow the interactive prompts to enter your URL and Secret.\n\n---\n\n## 🆕 Changelogs\n\n### v1.7.0 (Smart Sync & Windows Power-Up)\n- **Automated Skill Sync:** Bi-directional synchronization for the `skills/` folder. The system now automatically detects which machine has the newest \"Lessons Learned\" and updates all connected instances (Server & Worker) instantly.\n- **Windows UTF-8 Fix:** Automated `chcp 65001` execution on startup. This eliminates Greek/Regional encoding errors (CP 737) and significantly speeds up terminal text streaming on Windows.\n- **Visual Reflection Feedback:**\n - **Global Logs:** Successful reflections are now recorded in the System Logs with a brain icon (🧠) and knowledge snippets.\n - **In-App Cues:** The Reflect button provides immediate \"LEARNING...\" and \"SUCCESS!\" states.\n- **Data Protection:** Updated `prepare-deploy.js` to include `users.json` in the deployment package.\n- **Stability:** Hardened reflection logic to remove disruptive `alert()` boxes and replaced them with non-blocking UI notifications.\n\n### v1.6.0 (Unified Intelligence & Team Sync)\n- **Env Support:** Integrated `dotenv` for seamless configuration via `.env` files.\n- **Conference Room 2.0:** Complete UI redesign with a specialized sidebar and \"Shared Memory\" logic.\n- **Shared Memory:** Agents in the Conference Room now \"hear\" each other by receiving the full room history.\n- **Global Brief Integration:** The Project Brief is now automatically attached to every message (Individual & Team).\n- **Interactive Help:** Added \"💡 Help\" buttons to Brief, Vault, and Conference Room for better onboarding.\n- **Gamified Evolution:** Upgraded XP bars with smooth animations and added \"Senior Status\" visuals (Gold borders, sparkles, and dual-monitor icons) for Level 3+ agents.\n- **Permanent Learning:** Fixed logic to ensure \"Lessons Learned\" are physically appended to your local skill markdown files.\n- **Security:** Hardened `.gitignore` and added `.env.example` templates.\n- **Bug Fixes:** Fixed socket relay logic for group messages and manual SEND button sync.\n\n### v1.5.2 (Complete Branding & Quick-Connect)\n- **Instant Setup:** New **🔌 CONNECT** button provides an auto-generated setup guide.\n- **Branding:** Full transition to **CLI Agents HQ** with high-res logos and assets.\n- **Stability:** Migrated all local machine interactions to high-stability Socket.io tunnels.\n\n### v1.5.1 (Secure Hybrid Mode)\n- **Security:** Integrated JWT-based login system and role-based user management.\n- **Hybrid Logic:** Dashboard stores state online while execution remains strictly local.\n- **UI UX:** Added Full-Screen focus mode and real-time tab notifications.\n\n---\n*Built for the next generation of secure, collaborative AI development.*\n"}
![\"CLI](\"banner.png\")
\n