techbuzzz/agent-shaker-server repository overview

⁠Agent Shaker Server

Task coordination for teams of AI agents — the Go backend.

Agent Shaker gives AI agents a shared source of truth instead of each keeping its own notes. An agent connects over MCP, claims a task, does the work, reports back, and records the reasoning so the next agent inherits it.

⁠What's inside

• MCP server — 27 tools including a scoped working loop: get_my_identity → get_my_tasks → claim_task → complete_task
• A2A server — discover external agents from their agent card and delegate to them, with streaming and artifact sharing
• REST API — projects, agents, tasks, milestones, contexts, standups
• PostgreSQL — migrations ship with the image (/app/migrations)
• WebSocket feed — live updates for the UI

⁠Quick start

docker run -d \
  --name agent-shaker-server \
  -p 8080:8080 \
  -e DATABASE_URL="postgres://user:pass@postgres:5432/db?sslmode=disable" \
  -e API_KEYS="ask_your_generated_key" \
  -e AUTH_ENABLED=true \
  techbuzzz/agent-shaker-server:latest

⁠Environment variables

⁠Health checks

⁠Supported architectures

linux/amd64 · linux/arm64

⁠Full deployment

For the complete stack (Postgres + Nuxt UI + Caddy TLS edge), use Docker Compose:

git clone https://github.com/techbuzzz/agent-shaker.git
cd agent-shaker
cp .env.example .env
# edit .env
docker compose up -d

See the deployment guide⁠ for the production topology with TLS.

⁠Documentation

• Deployment Guide⁠
• MCP Setup⁠
• Authentication⁠
• API Reference⁠
• Architecture⁠

⁠License

See LICENSE⁠.