# Helios

> Open-source Linux desktop for Claude Code, Codex, Gemini through Antigravity, Muse Code, Kimi Code and OpenRouter.

Guidance reviewed against Helios 0.114.4. Native providers keep their own sign-in and account entitlements. Capabilities, permissions, context reporting and billing differ. Stable APT may lag behind the current GitHub release.

## Start here

- [Overview](https://norvitech.com/helios/): purpose, features and demonstrations.
- [User guide and search](https://norvitech.com/helios/docs/): the complete navigable guide.
- [Install Helios](https://norvitech.com/helios/install/): current package, checksums, source dependencies and update channels.
- [Compare providers](https://norvitech.com/helios/providers/): six native and API integration routes.
- [Claude Code and Codex on Linux](https://norvitech.com/helios/vs-terminal/): compare the GUI with a terminal and try a local preview, test and Git review.
- [Video walkthroughs](https://norvitech.com/helios/demos/): captioned app recordings and transcripts; fictional staged demonstration data.

## Start here

- [Your first project and chat](https://norvitech.com/helios/docs/first-chat/): Choose a project folder, connect a coding provider, send your first Helios task and review the result.

## Providers

- [Claude Code on Linux](https://norvitech.com/helios/docs/provider-claude/): 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](https://norvitech.com/helios/docs/provider-codex/): 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](https://norvitech.com/helios/docs/provider-gemini/): Set up Google Antigravity account sign-in for Gemini sessions in Helios, verify live models and understand headless permissions.
- [Muse Code on Linux](https://norvitech.com/helios/docs/provider-muse/): 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](https://norvitech.com/helios/docs/provider-kimi/): 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](https://norvitech.com/helios/docs/provider-openrouter/): 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](https://norvitech.com/helios/docs/sessions/): Find and resume coding sessions, organize projects, fork a conversation and isolate changes with Git worktrees in Helios.
- [Messages, files and images](https://norvitech.com/helios/docs/composer/): Write Helios prompts, attach project files and screenshots, queue follow-ups and understand provider-specific image support.
- [Permissions and approvals](https://norvitech.com/helios/docs/permissions/): Choose Helios execution permissions, respond to tool approvals and questions, and understand each provider's limits.
- [Works, goals and plans](https://norvitech.com/helios/docs/works-and-goals/): Use Helios Works, goals, plans and Missions to follow a coding task, with clear budget, pause and completion expectations.

## Workspace

- [Context, memory and tools](https://norvitech.com/helios/docs/context-and-tools/): Inspect Helios context usage, Claude memory, shared context and tool capabilities, and configure MCP integrations.
- [Git review and checkpoints](https://norvitech.com/helios/docs/git-review/): Review Helios Git diffs, stage individual hunks, send feedback, commit, push and use checkpoints with the right recovery expectations.
- [Browser previews and screenshots](https://norvitech.com/helios/docs/browser/): Preview local websites in Helios, inspect pages, capture screenshots and connect project run configurations to the browser pane.
- [Terminal and background work](https://norvitech.com/helios/docs/terminal/): Run commands in Helios's project terminal, send selected output to chat and follow supported background tasks.
- [Shared handoffs and Missions](https://norvitech.com/helios/docs/integrations/): Configure optional Helios shared-context handoffs, tandem Missions, session pools and routing integrations with clear prerequisites and execution limits.

## Reference

- [Settings and provider accounts](https://norvitech.com/helios/docs/settings/): Configure Helios appearance, accounts, model discovery, title generation, context and execution settings.
- [Data, backups and upgrades](https://norvitech.com/helios/docs/data-and-backups/): Find Helios local data and provider histories, back up a stopped app, restore carefully and choose the right update channel.
- [Troubleshooting and support](https://norvitech.com/helios/docs/troubleshooting/): Fix Helios launch, sign-in, missing models, permissions, browser and package problems, and prepare a useful support report.
- [Keyboard shortcuts](https://norvitech.com/helios/docs/shortcuts/): A practical reference for Helios keyboard shortcuts, message editing, session navigation and workspace controls.

## Project sources

- [GitHub](https://github.com/spencernorton/helios)
- [Latest release](https://github.com/spencernorton/helios/releases/latest)
- [Shell setup reference](https://github.com/spencernorton/helios/blob/main/docs/agent-setup.md)
- [Security policy](https://github.com/spencernorton/helios/blob/main/SECURITY.md)
- [Changelog](https://github.com/spencernorton/helios/blob/main/CHANGELOG.md)