Basecamp Sherpa
ServicesDocker

Development

Docker Compose setup for local development.

For the application-level workflow (authentication, testing webhooks), see Agent Development.

Start the dev environment

pnpm agent:dev

This runs docker-compose up with services/docker/docker-compose.yml.

Services

sherpa (Agent)

  • Port: 3000:3000
  • Source mount: apps/agent/src for hot reload
  • Persistent volume: .volumes/root-dev → /root (stores Claude and Basecamp credentials)
  • Command: pnpm --filter agent dev

hookdeck (Webhook tunnel)

  • Depends on: sherpa
  • Tunnels: http://sherpa:3000/webhooks to a public Hookdeck URL
  • Auth: Set HOOKDECK_API_KEY in .env

Persistent storage

The .volumes/root-dev/ directory persists across container restarts:

PathContents
.claude/Claude auth tokens and plugin cache
.config/basecamp/Basecamp OAuth credentials
.logs/Webhook processing logs
memory.jsonProcessed webhook deduplication

Docker

Docker Compose for development and multi-stage Dockerfile for production.

Production

Build and publish the Docker image for the Agent.