Overview

AgCluster is a self-hosted platform for Claude Agent SDK agents, born from falling down the Claude Agent SDK rabbit hole. It provides complete visibility into agent execution with Docker isolation, real-time monitoring, and a Next.js 15 dashboard. What started as “what if I could spin off agents just with a simple YML?” evolved into a full platform for building and managing AI agents.

Key Features

  • Docker Isolation: Each agent session runs in its own isolated container with resource limits and security hardening
  • Real-Time Monitoring: SSE streaming shows every tool execution—Bash commands, file operations, web requests—as they happen
  • 4 Preset Agent Configs: Jump-start with code-assistant, research-agent, data-analysis, or fullstack-team configurations
  • Multi-Agent Orchestration: The fullstack-team preset coordinates specialized agents (frontend, backend, devops) working together
  • Task Tracking: TodoWrite integration with live status updates for visual progress tracking
  • Custom Agent Configs: Build your own agents with simple YAML configurations

The Journey

Last few weeks I’ve been exploring Claude Code’s possibilities. Claude Agent SDK is truly special—File System Tools (Read, Write, Edit), Bash with full CLI access, Web Fetch, and Web Search provide incredible building blocks. Add in the superpowers like sub-agents, custom tools, MCP support, and skills, and the possibilities get pretty wild.

The “what if” moment: what if each agent session could run in its own isolated container with full visibility?

Technology Stack

  • Frontend: Next.js 15 with real-time dashboard
  • Backend: FastAPI control plane
  • Runtime: Docker containers for isolation
  • Agent Framework: Claude SDK
  • Streaming: SSE/WebSockets for real-time updates
  • Testing: 212 tests, 66% code coverage

Performance

  • 2-3s container boot time (local Docker)
  • 300ms boot with Fly Machines
  • Supports 10+ concurrent sessions
  • Auto-cleanup after 30 min idle

Use Cases

  • Development Agents: Build agents that execute code, modify files, run tests, and deploy
  • Research & Analysis: Agents that search the web, analyze data, and generate reports
  • Data Analysis: Jupyter-capable agents for statistical analysis and visualization
  • Code Review Bots: Automated PR reviews with security scanning
  • Multi-Agent Teams: Coordinate specialized agents for complex development tasks

Open Source

MIT licensed and actively developed. Docker compose up and you’re running in ~3 minutes. Still learning what’s possible here.

GitHub: https://github.com/whiteboardmonk/agcluster-container