run-centaur-dev

Launch and validate the complete Centaur development stack locally.

4|2|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/useatrium/atrium --skill run-centaur-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-centaur-dev
Source: https://github.com/useatrium/atrium/tree/main/centaur/.agents/skills/run-centaur-dev
Command: npx skills add https://github.com/useatrium/atrium --skill run-centaur-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the complex process of running the full Centaur development environment locally, coordinating the API, sandbox infrastructure, credentials, Slack integration, and end-to-end validation.

Core Features & Use Cases

  • Local Stack Orchestration: Starts the Rust API, PostgreSQL, Kind-based agent sandboxes, and Slackbot V2 with the required configuration.
  • Secure Credential Setup: Uses 1Password and iron-proxy patterns to provide model and tool credentials without exposing secret values.
  • Integration Testing: Configures Tailscale Funnel and Slack app webhooks, then validates agent sessions with centaur-session-cli.
  • Troubleshooting Guidance: Provides checks and recovery steps for sandbox connectivity, image loading, authentication, Slack delivery, and event streaming.
  • Use Case: Use this Skill when developing or debugging Centaur locally and you need to verify the complete path from a Slack mention to a live agent session in a Kind sandbox.

Quick Start

Ask the Skill to bring up the full Centaur development stack locally and run an end-to-end Slack or centaur-session-cli smoke test.

Frequently Asked Questions about run-centaur-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run the full Centaur development stack locally for end-to-end testing?

To run the Centaur development stack locally, you need to orchestrate the Rust API, PostgreSQL, Kind-based agent sandboxes, and Slackbot V2. This Skill coordinates starting these services and validates the complete path from a Slack mention to a live agent session.

What prerequisites are needed to launch the Centaur local development environment?

Launching the Centaur local environment requires cargo, Docker, Kind, kubectl, just, Bun, Tailscale, 1Password, PostgreSQL, configured sandbox images, and locally managed credentials. These tools are necessary to support the API, sandbox infrastructure, and secure credential setup.

How does local agent sandbox testing work with Kind and a Rust API?

Local agent sandbox testing uses Kind to run Kubernetes-based sandboxes coordinated with the Rust API. The Skill validates agent sessions within these sandboxes by configuring the necessary infrastructure and running end-to-end smoke tests using centaur-session-cli.

Can I use 1Password and Tailscale Funnel for secure Slack webhook integration?

Yes, you can use 1Password and Tailscale Funnel for secure Slack webhook integration. The Skill uses 1Password and iron-proxy patterns to provide model and tool credentials without exposing secret values, while Tailscale Funnel exposes the webhooks locally.

Why is my local Centaur Slackbot integration not delivering events to the agent sandbox?

If your local Centaur Slackbot integration is not delivering events, check the sandbox connectivity, image loading, authentication, and Slack delivery configurations. This Skill provides specific troubleshooting checks and recovery steps for these event streaming and delivery issues.

What is the best way to smoke test a Slack mention to live agent session path locally?

The best way to smoke test the Slack mention to live agent session path is to orchestrate the complete stack and validate it end-to-end. This Skill automates the setup of Tailscale webhooks and Kind sandboxes, then runs centaur-session-cli smoke tests to verify the integration.