# Agentrooms: Multi-Agent Claude Code Orchestration Desktop App

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/baryhuang-agentrooms
Generated for open source discovery and AI-assisted research.

Agentrooms is a desktop application and API designed for multi-agent Claude Code orchestration. It enables users to coordinate both local and remote agents through an intuitive @mentions system, streamlining complex development workflows. This tool facilitates collaborative development by routing tasks to specialized agents, all while leveraging your existing Claude subscription without requiring additional API keys.

GitHub: https://github.com/baryhuang/agentrooms
OSRepos URL: https://osrepos.com/repo/baryhuang-agentrooms

## Summary

Agentrooms is a desktop application and API designed for multi-agent Claude Code orchestration. It enables users to coordinate both local and remote agents through an intuitive @mentions system, streamlining complex development workflows. This tool facilitates collaborative development by routing tasks to specialized agents, all while leveraging your existing Claude subscription without requiring additional API keys.

## Topics

- Claude API
- Multi-Agent Systems
- Desktop App
- TypeScript
- AI Development
- MacOS App
- Code Orchestration
- Agent Planning

## Repository Information

Last analyzed by OSRepos: Wed Dec 10 2025 00:01:04 GMT+0000 (Western European Standard Time)
Detail views: 11
GitHub clicks: 13

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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

1.  **Claude Subscription**: Requires Claude Pro, Team, or Enterprise subscription.
2.  **Install Claude CLI**: Download from the official [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code){:target="_blank"}.
3.  **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](https://github.com/baryhuang/claude-code-by-agents/releases){:target="_blank"} 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:**

bash
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

bash
# 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:

bash
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:

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

## Links

*   **GitHub Repository**: [baryhuang/claude-code-by-agents](https://github.com/baryhuang/claude-code-by-agents){:target="_blank"}
*   **Releases Page**: [Download Agentrooms](https://github.com/baryhuang/claude-code-by-agents/releases){:target="_blank"}
*   **Claude Code Documentation**: [Learn more about Claude CLI](https://docs.anthropic.com/en/docs/claude-code){:target="_blank"}