Terminal app

Run helios to open a full-screen app with chat, workflows, projects, access, and Helios Code. Jump anywhere with the command palette.

Run helios with no arguments in a terminal and the app opens.

helios

helios chat opens the app on the chat screen. helios code opens it on the Code screen.

helios code

Outside a terminal, for example in a pipe, helios prints help instead.

Home

The home screen shows the Helios logo, a new-chat input, and your recent chats. Type a message and press Enter to start a chat. Use the arrow keys to pick a recent chat.

Key	Action
`Enter`	Start a new chat, or open the selected one
`Up`, `Down`	Move through recent chats
`ctrl-r`	Refresh the list
`Esc`	Quit

Command palette

Press ^p anywhere to open the command palette. It lists the sections, recent chats, and the open tabs of an attached agent. Type to filter. Press Enter to jump. Press Esc to close it.

Palette entries include the following.

Go to Chat
Go to Workflows
Go to Access
Go to Groups
Go to Service accounts
Go to Projects
Go to Code
New chat
Recent chats by title
Tab: <name> for each open tab while attached

Screens

Chat

Chat renders Markdown, shows a thinking indicator while the agent works, and gives each chat a title. Press Esc twice to leave a chat. Press s on a chat to share it.

Workflows

Search your workflows and see recent runs.

Key	Action
`t`	Trigger the selected workflow
`s`	Open the share overlay
`A`	Pick the service account the workflow runs as

Projects

Switch, search, create, rename, and delete projects. Everything in the app is scoped to the active project. The footer shows its name. The personal project cannot be deleted.

Access

Access has three sub-views.

Shared with me. Every grant you hold, with a type filter and search. Press Enter to jump to the resource.
Groups. Create, rename, and delete groups. Add or remove members.
Service accounts. List accounts with status and role. The detail view shows the workflows each account is used in and what it has access to. Named accounts can be created, renamed, enabled, disabled, and deleted. Project defaults are read-only.

Press s on a chat or a workflow to open the share overlay. It lists every grant with markers for inherited grants and expiry.

Key	Action
`a`	Add a grant. Pick a principal and a role.
`+`, `-` or `Right`, `Left`	Raise or lower a role. Capped at your own role.
`x`	Revoke the grant

Share rules match the dashboard. Chats can only be shared as viewer, expire in one day, and cannot be shared with the whole org. See projects and sharing.

Code

Code has four sub-views. Agents, Environments, Images, and Configure.

Agents shows each running agent with a color-coded status. Launch an agent by picking an environment, watch the boot logs, and attach. Press ctrl-r to reload the list.

Attached sessions

When you attach to an agent, the screen shows a tab strip. The first tab is the coding harness. A files tab appears for each repository the agent edits. See files tab.

Key	Action
`ctrl-x`	Detach. The agent keeps running.
`^p`	Open the palette. Switch tabs from here.

Attach again at any time.

helios code attach

Without an id, this attaches to the last launched agent.

On this page