Agentrooms: Multi-Agent Claude Code Orchestration Desktop App

Introduction

Agentrooms is a desktop application and API designed for multi-agent Claude Code orchestration. It provides a collaborative development workspace where users can route tasks to specialized agents, coordinating complex workflows seamlessly. This tool supports both local and remote agents, enabling dynamic team environments without requiring additional API keys, as it leverages your existing Claude subscription via Claude CLI authentication.

Key features include:

@agent-name mentions: Direct execution without orchestration overhead.
Multi-agent workflows: Automatic task decomposition and coordination.
Local + Remote agents: Mix local agents with remote machines (e.g., Mac Mini browser agent, cloud instances).
No API key required: Uses your Claude subscription through Claude CLI authentication.
Multi-agent orchestration: Intelligent task coordination between specialized agents.
Custom API support: Configure your own endpoint for private deployment.
Dynamic agents: Add and remove agents via the web UI.

Installation

To get started with Agentrooms, ensure you meet the prerequisites and then choose your preferred installation method.

Prerequisites

Claude Subscription: Requires Claude Pro, Team, or Enterprise subscription.
Install Claude CLI: Download from the official Claude Code documentation.
Authenticate: Run claude auth login and complete OAuth authentication. This connects Agentrooms to your Claude subscription, using OAuth tokens securely without needing API keys.

Option 1: Desktop App (Recommended)

Download Pre-built App:
Visit the Releases page to download the appropriate installer for your operating system.

Windows: claude-code-webui-windows-x64.exe - Run the installer.
macOS Intel: claude-code-webui-macos-x64 - Drag to Applications folder.
macOS Apple Silicon: claude-code-webui-macos-arm64 - Drag to Applications folder.
Linux x64: claude-code-webui-linux-x64 - Make executable and run.
Linux ARM64: claude-code-webui-linux-arm64 - Make executable and run.

Important: Remember to start the backend service separately as described in the "Backend Setup" section below.

Build from Source:

git clone https://github.com/baryhuang/claude-code-by-agents.git
cd claude-code-by-agents
npm install
npm run build:frontend
npm run dist:mac     # Creates macOS DMG in dist/ folder
npm run dist:win     # Creates Windows installer in dist/ folder
npm run dist:linux   # Creates Linux AppImage in dist/ folder

Option 2: Web Development

# Start backend service
cd backend && deno task dev        # Backend: http://localhost:8080

# Start frontend (separate terminal)
cd frontend && npm run dev         # Frontend: http://localhost:3000

Backend Setup (Required for Desktop Apps)

The desktop apps run frontend-only. You must start the backend service separately:

git clone https://github.com/baryhuang/claude-code-by-agents.git
cd claude-code-by-agents
cd backend && deno task dev
# Backend will run on http://localhost:8080

The Agentrooms app will automatically connect to localhost:8080. If your backend is on a different port, you may need to update the frontend configuration.

Agent Setup (Optional)

You can start additional agent instances and configure them in the Settings UI:

cd path/to/agent1 && deno task dev --port 8081   # Local agent
cd path/to/agent2 && deno task dev --port 8082   # Local agent
# Remote agents: Run on other machines, expose ports

Examples

Agentrooms simplifies both single-agent and multi-agent workflows.

Single Agent Task

To direct a task to a specific agent, use @agent-name mentions:

@api-agent add user authentication

This makes a direct HTTP call to the agent's endpoint, minimizing orchestration overhead.

Multi-Agent Task

For more complex projects, the orchestrator can manage multiple agents:

"Create full auth system with frontend and backend"

In this scenario, the orchestrator analyzes the request, creates an execution plan, and coordinates file-based communication between agents. It automatically manages dependencies, ensuring a smooth workflow.

Why Use Agentrooms?

Agentrooms stands out by offering a powerful, flexible, and user-friendly environment for AI-driven development with Claude Code.

Seamless Multi-Agent Coordination: Automate task decomposition and intelligent coordination between specialized agents, significantly boosting productivity for complex projects.
Flexible Agent Deployment: Integrate both local and remote agents into your workflow, allowing for diverse development setups and resource utilization.
Cost-Effective: Leverage your existing Claude subscription without the need for additional API keys or separate billing, as all operations run through your authenticated Claude CLI session.
Intuitive Interaction: The @mentions system provides a natural way to direct tasks and manage agent interactions, reducing manual orchestration efforts.
Customizable and Dynamic: Easily add, remove, and configure agents via the web UI, and even set up custom API endpoints for private deployments.

Agentrooms: Multi-Agent Claude Code Orchestration Desktop App

Summary

Repository Information

Topics

Use at your own risk