Files
paseo/public-docs/hub/index.md
T
Mohamed BoudraandGitHub deb5e5c729 docs(hub): document durable workflow routing (#2943)
* docs(hub): document durable workflow routing

* docs(hub): make workflow guide progressive
2026-08-06 16:07:41 +02:00

1.9 KiB

title, description, nav, order, category
title description nav order category
Hub The layer above your daemons. Register them, give them capabilities, and share them with your team. Overview 60 Hub

Hub

A daemon runs agents on one machine, for you. Paseo Hub is the layer above your daemons. You register your daemons with it, and it gives them capabilities they do not have on their own.

             Hub
    ┌─────────┼─────────┐
    ▼         ▼         ▼
 laptop    devbox    build server

What that gives you today:

  • Agents that start on their own, from activity in GitHub, Slack, and Discord.
  • Configuration that lives in a repository and deploys when you push.
  • A record of everything that arrived, what it matched, and what ran.
  • One place for your team to see all of it.

Your daemons keep running agents where they always did. Hub decides when to ask them to.

How it fits together

An organization holds your connections to GitHub, Slack, and Discord, and your registered daemons. Projects sit inside it, and each project has its own configuration.

organization
├── connections
├── daemons
└── projects

A project is one set of environments and triggers. Split your work into projects the way you already split it in your head: one per product, per team, or per repository. Connections and daemons are shared across all of them, so a new project does not mean connecting GitHub again.

How Hub works covers this properly.

Reading order

  1. How it works
  2. Daemons
  3. Triggers
  4. Workflows
  5. Configuration

Quickstart goes end to end if you would rather start by doing.

Running it

Two ways: hosted or self-hosted. Everything above is the same either way.