paradigmxyz/centaur-acme

Example organization overlay for Centaur.

Package your tools, workflows, skills, and sandbox guidance as a reusable overlay image.

Use This Template • What You Customize • Build • Verify

Overview

centaur-acme is a public, forkable template for creating an organization overlay for Centaur. It is intentionally small and free of private data. Use it as the starting point for shipping org-specific capabilities without forking the core platform.

The overlay image is copied into Centaur at runtime:

centaur-acme repo
    |
    v
overlay image
    |
    +-- /app/overlay/org in the API
    +-- /home/agent/overlay/org in sandbox pods

Use This Template

1. Click Use this template in GitHub, or fork the repo if you want to keep a visible upstream relationship.
2. Rename ACME examples to your organization or team name.
3. Replace the toy CRM tool with one small real integration.
4. Update the sandbox prompt and skill to match the behavior your agents should follow.
5. Build and publish the overlay image, then point your Centaur Helm values at that image.

Keep credentials out of this repository. Tools should request secrets through Centaur’s secret system instead of committing values or .env files.

What You Customize

The template demonstrates the extension points an organization normally owns:

• tools/ for API-discovered tools
• workflows/ for durable workflows
• .agents/skills/ for sandbox-loaded skills
• services/sandbox/SYSTEM_PROMPT.md for organization-specific agent guidance

Repository Map

.
├── .agents/skills/acme-support/     # sandbox skill loaded with the overlay
├── services/sandbox/SYSTEM_PROMPT.md
├── tools/acme_crm/                  # packaged Python CLI tool with sample data
├── tools/acme_go/                   # minimal Go CLI tool
├── tools/acme_rust/                 # minimal Rust CLI tool
├── workflows/daily_acme_brief.py    # example durable workflow
├── tests/
└── Dockerfile                       # copies the overlay to /overlay

Build the overlay image

docker build -t ghcr.io//:local .

The image copies this repository to /overlay. Centaur’s Helm chart mounts that path at /app/overlay/org in the API and /home/agent/overlay/org in sandbox pods.

Use with Helm

overlay:
  image:
    repository: ghcr.io//
    tag: sha-0000000
    pullPolicy: IfNotPresent
    sourcePath: /overlay

For the full GitOps example, pair this repo with