Orchestration backend for multi-agent AI teams. AgentCrew deploys and manages teams of Claude Code agents that collaborate through NATS messaging, with support for both Docker and Kubernetes runtimes.
┌─────────────┐ ┌──────────┐ ┌───────────────────────────────┐
│ Frontend / │ │ │ │ Agent Container / Pod │
│ API Client │──────▶│ API │──────▶│ ┌─────────┐ ┌───────────┐ │
│ │ HTTP │ Server │ │ │ Sidecar │──│ Claude │ │
└─────────────┘ │ │ │ │ (Go) │ │ Code CLI │ │
└────┬─────┘ │ └────┬─────┘ └───────────┘ │
│ └───────┼─────────────────────┘
│ │
┌────▼─────────────────────▼──┐
│ NATS Server │
│ (JetStream enabled) │
└─────────────────────────────┘
- API Server (
cmd/api) — Fiber-based REST API that manages team lifecycles, agent deployments, and chat routing
- Agent Sidecar (
cmd/sidecar) — Runs inside each agent container, bridging NATS messages to the Claude Code CLI process
- NATS — Message bus for real-time communication between the API server and agents
| Component |
Technology |
| Language |
Go 1.25+ |
| HTTP Framework |
Fiber v2 |
| Database |
SQLite via GORM |
| Messaging |
NATS with JetStream |
| Container Runtimes |
Docker Engine API, Kubernetes client-go |
| WebSocket |
Fiber WebSocket middleware |
# Clone the repository
git clone https://github.com/helmcode/agent_crew_api.git
cd agent_crew_api
# Copy environment template
cp .env.example .env
# Start all services (API + NATS)
docker compose up -d
# Verify the API is running
curl http://localhost:8080/health
# Build both binaries
make build-all
# Run tests
make test
# Lint
make lint
# Build Docker images
make build-images
# Clean build artifacts
make clean
| Method |
Path |
Description |
GET |
/health |
Health check |
| Method |
Path |
Description |
GET |
/api/teams |
List all teams |
POST |
/api/teams |
Create a team (optionally with agents) |
GET |
/api/teams/:id |
Get a team by ID |
PUT |
/api/teams/:id |
Update a team |
DELETE |
/api/teams/:id |
Delete a team |
POST |
/api/teams/:id/deploy |
Deploy team infrastructure and agents |
POST |
/api/teams/:id/stop |
Stop and teardown team |
| Method |
Path |
Description |
GET |
/api/teams/:id/agents |
List agents in a team |
POST |
/api/teams/:id/agents |
Add an agent to a team |
GET |
/api/teams/:id/agents/:agentId |
Get an agent |
PUT |
/api/teams/:id/agents/:agentId |
Update an agent |
DELETE |
/api/teams/:id/agents/:agentId |
Remove an agent |
| Method |
Path |
Description |
POST |
/api/teams/:id/chat |
Send a chat message to the team |
GET |
/api/teams/:id/messages |
Get chat message history |
| Method |
Path |
Description |
GET |
/api/settings |
Get application settings |
PUT |
/api/settings |
Update a setting |
| Path |
Description |
ws://host/ws/teams/:id/logs |
Stream agent logs in real-time |
ws://host/ws/teams/:id/activity |
Stream team activity events |
| Variable |
Default |
Description |
NATS_AUTH_TOKEN |
(optional) |
NATS authentication token |
NATS_URL |
nats://nats:4222 |
NATS server URL (sidecar) |
DATABASE_PATH |
agentcrew.db |
SQLite database file path |
LISTEN_ADDR |
:8080 |
HTTP server listen address |
RUNTIME |
docker |
Container runtime: docker or kubernetes |
KUBECONFIG |
~/.kube/config |
Kubeconfig path (Kubernetes runtime only) |
AgentCrew supports two container runtimes, selected via the RUNTIME environment variable:
Each team gets a Docker network, workspace volume, and NATS container. Agents run as Docker containers attached to the team network.
Each team gets a Kubernetes namespace with a workspace PVC, NATS Deployment + Service, and API key Secret. Agents run as Pods in the team namespace. Supports both in-cluster and kubeconfig-based authentication.
.
├── cmd/
│ ├── api/ # Orchestrator API server entrypoint
│ ├── sidecar/ # Agent sidecar entrypoint
│ └── testserver/ # Test server with mock runtime
├── internal/
│ ├── api/ # Fiber routes, handlers, middleware, DTOs
│ ├── claude/ # Claude Code process manager (sidecar)
│ ├── models/ # GORM models and SQLite database setup
│ ├── nats/ # NATS client wrapper for pub/sub messaging
│ ├── permissions/ # Permission gate logic for agent actions
│ ├── protocol/ # Shared message types (JSON protocol)
│ └── runtime/ # Container runtime interface (Docker, Kubernetes)
├── build/
│ ├── api/ # API server Dockerfile
│ └── agent/ # Agent container Dockerfile
├── docker-compose.yml # Local development stack
├── Makefile # Build, test, and lint commands
├── go.mod
└── go.sum
This project is licensed under the GNU Affero General Public License v3.0.