dispatch¶

dispatch is an opinionated, one-command deployment of hermes-agent — a long-running coding agent that lives in your Slack workspace and runs on your own AWS account.

One npx command generates a repository for your own dispatch agent. The generated repo is a set of skills you open in your favorite harness; the skills deploy the agent to AWS ECS and manage it for the rest of its life.

This documentation covers what a dispatch agent is, how to generate one, and how to set up, manage, upgrade, and tear it down.

Get started

Where to go next¶

• Getting started — generate a repo and deploy your first agent
• Architecture — what the CloudFormation stack builds on AWS
• Concepts: skills — the three skills that run the lifecycle
• Concepts: security model — the deployer/service-role split
• Concepts: secrets — SSM SecureStrings under /dispatch/
• CLI reference — npx @boldblackai/create-dispatch flags
• Upgrading — rolling the running agent to a new image tag
• Tearing down — removing every AWS resource