Multi-agent workspace for collaborative development with Claude CLI. Route tasks to specialized agents (local or remote), coordinate complex workflows.

Current Status: This version supports one agent room. Multiple rooms support is planned for future releases - contributions welcome!

Forked from sugyan/claude-code-webui

• @agent-name mentions: Direct execution, no orchestration overhead
• Multi-agent workflows: Automatic task decomposition and coordination
• Local + Remote agents: Mix local agents and remote machines (Mac Mini browser agent, cloud instances, etc.)
• Free orchestrator Anthropic usage: No API key required (uses my endpoint to cover your cost by default ) Sure you can bring your own API_KEY
• Custom API support: Configure your own endpoint in Settings
• Dynamic agents: Add/remove agents via web UI

• Planner: Uses API key for task analysis and coordination
• Agents: Use your local Claude CLI subscription for execution
• Default: Free public endpoint (zero setup)
• Custom: Set your API URL in Settings for private deployment

1. Install Claude CLI: Download from Claude Code documentation
2. Authenticate: Run claude auth login and complete the authentication

Download Pre-built App:

• Download from Releases
• Intel Mac: Agentrooms-0.0.1.dmg
• Apple Silicon: Agentrooms-0.0.1-arm64.dmg
• Install by dragging to Applications folder
• Important: Start the backend service separately (see Backend Setup below)

Build from Source:

# Clone and build
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 DMG in dist/ folder

# 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

The DMG app runs frontend-only. Start the backend service separately:

# Clone the repository
git clone https://github.com/baryhuang/claude-code-by-agents.git
cd claude-code-by-agents

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

Configure Frontend to Connect:

• Open the Agentrooms app
• Frontend will automatically connect to localhost:8080
• If backend is on different port, update frontend config

# Start additional agent instances
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

# Configure agents in Settings UI

Single agent: @api-agent add user authentication

• Direct HTTP call to agent endpoint
• No coordination overhead

Multi-agent: "Create full auth system with frontend and backend"

• Orchestrator analyzes and creates execution plan
• Coordinates file-based communication between agents
• Manages dependencies automatically

1. API Configuration:

   • Default: Uses free public endpoint
   • Custom: Set your API endpoint URL

2. Add Agents (local or remote):

   • Name: API Backend Agent
   • Description: Handles backend API development
   • Working Directory: /path/to/backend
   • API Endpoint: http://localhost:8081 (local) or http://mac-mini.local:8081 (remote)

3. Agent Routing:

   • First agent = orchestrator
   • @mentions route to specific agents
   • General requests use orchestrator

Frontend → Main Backend (Orchestrator) → Local Agent 1 (localhost:8081)
                                      → Local Agent 2 (localhost:8082)  
                                      → Remote Agent 3 (mac-mini.local:8081)
                                      → Remote Agent N (cloud-instance:8081)

Single Agent Flow:

User → @agent-name → HTTP Request → Agent's Claude Instance → Response

Multi-Agent Flow:

User → General Request → Orchestrator Analysis → Execution Plan
                                                ↓
Agent 1 ← Step 1 ← File Dependencies ← Coordination Logic
Agent 2 ← Step 2 ← Read Step 1 Output  
Agent N ← Step N ← Read Previous Results

# Run in development mode
npm run electron:dev    # Opens app with dev server

# Build production DMG
npm run build:frontend  # Build frontend first
npm run dist:mac       # Creates DMG files in dist/

# Backend (Terminal 1)
cd backend && deno task dev        # http://localhost:8080

# Frontend (Terminal 2) 
cd frontend && npm run dev         # http://localhost:3000

make check      # Format, lint, typecheck, test all components
make format     # Format code with prettier
make test       # Run frontend and backend tests
make lint       # Lint TypeScript code

make build-backend   # Build Deno binary
make build-frontend  # Build React frontend
npm run dist        # Build all platforms (DMG, Windows, Linux)

• Lefthook: Pre-commit hooks ensure quality
• TypeScript: Full type safety
• HTTP APIs: RESTful agent communication
• Dynamic config: All agents configurable via UI

MIT License