10 min
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.
5,000 free credits to start.
- 01
Install the binary
The CLI ships as a single binary for macOS and Linux. Run the install script from the CLI docs, then check it with `helios version`. `helios doctor` checks that your machine is ready.
- 02
Create an API key in the dashboard
The CLI signs in with an API key. Create one in the Helios dashboard first. Browser login from the terminal is not available yet.
- 03
Run helios configure
`helios configure` asks for the API key, then a project. Progress is saved to `~/.helios/onboarding.json`, so you can stop and resume. `helios configure --redo <step>` repeats one step.
- 04
Set the active project
Every command is scoped to a project. Switch with `helios project use`, set `HELIOS_PROJECT`, or pass `--project` on one command. `helios auth whoami` shows the project and your role.
- 05
Open the terminal app
Run `helios` with no arguments for the full-screen app. The home screen shows recent chats and a new chat input. `^p` opens the command palette. Workflows can be searched, triggered with `t`, and shared with `s`.
- 06
Connect integrations from the terminal
`helios integration connect` starts an OAuth or Claude account connection and `helios integration wait` polls until it is ready. Integrations that use a pasted key, such as Stripe or Resend, still connect from the dashboard.
- 07
Script it
Every command prints JSON when its output is piped. `helios share`, `helios group`, and `helios service-account` manage access from scripts. `helios code iac scaffold`, `export`, and `apply` manage environments as YAML.
Keep going
Next guides
9 min
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.
10 min
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.
8 min
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.
Templates
Put it to work
Templates that use what this guide covers.
Engineering
Pull request reviewer
Reviews every pull request against your conventions and leaves inline comments only where it found something concrete.
Engineering
Standup without the meeting
Reads yesterday's commits, merges, and review queue, then posts a standup to Slack every weekday morning.
Engineering
Incident postmortem drafter
Rebuilds the incident timeline from Slack and GitHub, names the likely change, and drafts the write-up in Notion.
Try it in your workspace.
Start free, connect a tool, and write the first prompt in plain words.