AppsAgent
Agent
The Claude AI assistant that integrates with Basecamp.
The Agent is the core Sherpa service. It receives Basecamp webhooks, processes them using Claude, and posts AI-generated replies back to Basecamp.
Tech stack
- Framework: TanStack Start (React 19, Vite 7)
- AI: Claude Code CLI + Anthropic API
- Basecamp: Basecamp CLI for API access
- Runtime: Docker container with Node.js 22
- Webhooks: Hookdeck for reliable delivery and tunneling
How it works
- Basecamp sends a webhook (e.g.
comment_created) to the Agent's/webhooksendpoint - The Agent processes the payload with Claude using configured prompts and context
- Claude generates a response and posts it back to Basecamp as a comment
Key paths
| Path | Description |
|---|---|
apps/agent/src/ | Application source code |
services/docker/docker-compose.yml | Docker Compose for local dev |
services/docker/Dockerfile | Multi-stage production build |
.volumes/root-dev/ | Persisted credentials (Claude, Basecamp) |
The Agent runs on port 3000 in both development and production. See Ports for details.