Guides

Get your first workflow running.

Short step lists in the order you meet them. Run a workflow, put it on a trigger, give it tools and context, share it with your team, then move to the CLI and the Library.

Get started free
Read the docs

5,000 free credits to start.

  1. 01

    Run your first workflow

    Describe a task in plain words, give the agent one tool, and read the run. Ten minutes from an empty workspace to a transcript you can read end to end.

    10 min
  2. 02

    Put a workflow on a schedule

    Turn a working prompt into a standing task. Describe the cadence the way you would say it out loud. Helios writes the cron expression.

    8 min
  3. 03

    React to GitHub events

    Start a run the moment a pull request opens, a build finishes, or a tag lands. Filter down to exactly the events you want.

    12 min
  4. 04

    Connect a database

    Give a workflow Postgres, MySQL, or ClickHouse. It reads the schema, writes real SQL, and checks the results in its own sandbox.

    10 min
  5. 05

    Attach an MCP server

    Point Helios at a remote MCP server, choose which of its tools workflows may call, and use Helios itself over MCP from other clients.

    10 min
  6. 06

    Pin repositories as context

    Pin a GitHub repository to a workflow or a chat. The agent starts every run with it.

    7 min
  7. 07

    Use secrets and variables

    Keep the values a task needs out of the prompt. Variables hold configuration. Secrets hold credentials. The agent never sees a secret in plain text.

    8 min
  8. 08

    Share with your team

    Hand a workflow to the people who need it. Four roles decide who may view, run, or edit. Every run leaves a transcript of what happened.

    9 min
  9. 09

    Move from Relay.app to Helios

    Relay.app shut down on 16 July 2026. Paid accounts are deleted on 14 September 2026. Here is how each Relay concept maps to Helios, and what to export first.

    15 min
  10. 10

    Install and configure the Helios CLI

    Install one binary, run `helios configure`, and go from an API key to a running workflow in your terminal. Every command prints JSON when piped.

    10 min
  11. 11

    Review agent changes in the Library

    Agents propose edits to shared files. A person reviews the diff and approves or discards each one. Nothing reaches the team's files without approval.

    8 min

Start with the first guide.

Ten minutes from an empty workspace to a run transcript you can read end to end.

Get started free
Read the docs