Helios user guide

Install Helios, connect a provider and learn the workspace.

Reviewed against Helios 0.114.4. Provider accounts and model availability can change.

01 · InstallGet the current Linux release 02 · ConnectSign in to a coding provider 03 · Try itFinish a small project task

Prefer to watch? See short GIF demos or the complete app tour. Find shorter videos and transcripts in the video library. Helios does not include a model subscription; provider accounts are separate.

Start here

Your first project and chat

Choose a project folder, connect a coding provider, send your first Helios task and review the result.

Providers

Claude Code on Linux

Install Claude Code, verify its sign-in and use its native sessions, approvals, memory and message forks in Helios on Linux.

OpenAI Codex on Linux

Connect the OpenAI Codex CLI and App Server to Helios on Linux, choose account or API-key sign-in and verify models and approvals.

Gemini through Antigravity

Set up Google Antigravity account sign-in for Gemini sessions in Helios, verify live models and understand headless permissions.

Muse Code on Linux

Install Meta Muse Code and connect it to Helios through muse serve, with account checks, API-key precedence and background-work guidance.

Kimi Code membership

Connect Kimi Code membership to Helios through the native ACP integration, sign in, refresh models and understand thinking and permission limits.

OpenRouter models and API keys

Configure an OpenRouter API key in Helios, choose models from the live catalogue, understand reasoning support and verify metered usage.

Everyday work

Sessions, search and worktrees

Find and resume coding sessions, organize projects, fork a conversation and isolate changes with Git worktrees in Helios.

Messages, files and images

Write Helios prompts, attach project files and screenshots, queue follow-ups and understand provider-specific image support.

Permissions and approvals

Choose Helios execution permissions, respond to tool approvals and questions, and understand each provider's limits.

Works, goals and plans

Use Helios Works, goals, plans and Missions to follow a coding task, with clear budget, pause and completion expectations.

Workspace

Context, memory and tools

Inspect Helios context usage, Claude memory, shared context and tool capabilities, and configure MCP integrations.

Git review and checkpoints

Review Helios Git diffs, stage individual hunks, send feedback, commit, push and use checkpoints with the right recovery expectations.

Browser previews and screenshots

Preview local websites in Helios, inspect pages, capture screenshots and connect project run configurations to the browser pane.

Terminal and background work

Run commands in Helios's project terminal, send selected output to chat and follow supported background tasks.

Shared handoffs and Missions

Configure optional Helios shared-context handoffs, tandem Missions, session pools and routing integrations with clear prerequisites and execution limits.