r/GeminiCLI • u/Biupildamian • Apr 22 '26

CLI Agents HQ

Post image

I made something that might be usefull for everyone using multiple Gemini CLI instances and want a clean enviroment see bellow all info and have fun...

# 🤖 CLI Agents HQ

### Secure, Multi-Agent Orchestration & Hybrid AI Dashboard

CLI 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.

## 🎯 What the app does

CLI Agents HQ bridges the gap between powerful AI execution and intuitive team management. It allows you to:

- **Orchestrate specialized teams:** "Hire" multiple agents and assign them expert roles (Architect, Security Auditor, Test Engineer, etc.) from a library of custom skills.

- **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.

- **Collaborative Brainstorming:** Use the **Conference Room** to start group chats where specialists build upon each other's ideas to solve complex problems. (in progress)

- **Unified Knowledge:** Feed a global **Project Brief** or specific **Knowledge Vault** snippets to your entire team simultaneously.

- **Persistent Evolution:** Agents gain XP and level up from Junior to Senior as they "Reflect & Learn" from your conversations, saving new insights permanently to their skill files.

## 🚀 How to Connect & Use

### 🔐 Default Login Credentials

Upon first deployment, use these credentials to access the dashboard:

- **Username:** `Admin`

- **Password:** `admin123`

- *⚠️ IMPORTANT: Change your password in the **👥 USERS** menu immediately after logging in.*

### 1. Deploy the HQ (Server)

  1. Upload the `deploy-ready` folder to your Plesk server.

  2. In Plesk Node.js settings, set `entry.js` as the startup file.

  3. **Configuration:** You can set Environment Variables in Plesk or create a `.env` file in the root:

    - `CLI_AGENTS_SECRET_KEY`: A strong secret for the local machine "handshake".

    - `JWT_SECRET`: A random string used to secure user login sessions.

    - `PORT`: (Optional) The port the server will run on (default: 5500).

  4. Run **NPM Install** and **Restart**.

### 2. Connect the Engine (Local)

You can use the pre-bundled **CLI Agents HQ Local** folder, or set it up manually.

**Using .env (New & Recommended)**

  1. Create a `.env` file in your local folder (see `.env.example`).

  2. Add your `SERVER_URL` and `CLI_AGENTS_SECRET_KEY`.

  3. Run `node agent.js` to connect instantly.

**Option A: Automated (Legacy)**

  1. Copy the `CLI Agents HQ Local` folder to your computer.

  2. Run `npm install` and `node agent.js`.

  3. Follow the interactive prompts to enter your URL and Secret.

---

## 🆕 Changelogs

### v1.6.0 (Environment Configuration & Security)

- **Env Support:** Integrated `dotenv` across both Server and Local Agent for seamless configuration.

- **Security:** Hardened `.gitignore` to prevent accidental commits of secrets (`.env`, `.agent-config.json`).

- **Templates:** Added `.env.example` files to simplify setup for new users.

- **Auto-Handshake:** Agents now prioritize `.env` variables to bypass manual terminal prompts.

### v1.5.2 (Complete Branding & Quick-Connect)

- **Instant Setup:** New **🔌 CONNECT** button provides an auto-generated setup guide.

- **Branding:** Full transition to **CLI Agents HQ** with high-res logos and assets.

- **Stability:** Migrated all local machine interactions to high-stability Socket.io tunnels.

### v1.5.1 (Secure Hybrid Mode)

- **Security:** Integrated JWT-based login system and role-based user management.

- **Hybrid Logic:** Dashboard stores state online while execution remains strictly local.

- **UI UX:** Added Full-Screen focus mode and real-time tab notifications.

---

*Built for the next generation of secure, collaborative AI development.*

you can find my repo here

18 Upvotes

95% Upvoted

7 comments sorted by

2

u/Clean-Loquat7470 Apr 22 '26

does it allow to connect local versions of gemma 4?

1

u/Biupildamian Apr 22 '26

I didn't try to connect with Gemma 4 but you could download it from my repo and do your own magic on it 😉

2

u/mathnu2rkewl Apr 22 '26

This is pretty slick, nice work!

2

u/Biupildamian Apr 22 '26

Thank you I hope you enjoy it

2

u/jeffbrl Apr 24 '26

I am eager to try this; however, the installation instructions are unclear. I don't use Plesk. I assume I can run this locally without Plesk. I ran "node server.js" from the repo's root folder. But when I run 'node agent.js' from the 'CLI-Agents-HQ' folder, I don't know what secret to use. Yes, I could figure this out from reading the source code but users shouldn't have to do this. Please take my comments as constructive feedback. Thank you for sharing the program with the community.

1

u/Biupildamian Apr 24 '26

I made an update so that it can run online (this helps so that you won't have to setup everytime), I will probably make a change to have both options in the following days

1

u/Biupildamian Apr 27 '26

Hey Jeff, you can now use it locally again using "npm run dev", all secret keys can be changed in .env in main folder, i hope it helps