Getting started

Athas is an open-source code editor for macOS, Windows, and Linux. It brings files, Git, terminals, databases, and AI agents into one workspace. Local editing does not require an account.

Your first project

1. Install Athas for your operating system and CPU architecture.
2. Open a folder with Cmd+O on macOS or Ctrl+O on Windows and Linux, or drag it into Athas.
3. Open a file with Cmd/Ctrl+P, edit it, and save with Cmd/Ctrl+S.
4. Open the Command Palette with Cmd/Ctrl+Shift+P to discover actions.
5. Show the terminal with Cmd/Ctrl+J and run your project's usual commands.

Cmd/Ctrl means Command on macOS and Control on Windows/Linux. Shortcuts in these guides use the default Athas keymap; presets, custom bindings, and the focused pane can change them.

Find the right guide

I want to…	Start here
Navigate and edit code	Quick Open, Editing, Search
Get completions, symbols and errors	Language servers, Diagnostics, Formatting
Review and commit a change	Git, Diffs, Worktrees
Use an AI coding agent	AI overview, Athas Agent, External agents
Work across machines	Remote connections, WSL, Cloud Agents
Inspect data	Database viewer
Change my setup	Settings, Themes, Keymaps, Vim
Share work	Share to Web, Preview links, Collaboration
Fix a problem	Troubleshooting, Updates

Accounts and online features

Sign in for account-backed features such as hosted AI, settings sync, sharing and dashboard integrations. Requirements differ by feature: each guide states its account and plan limits. See pricing for current plans and Enterprise controls for managed workspaces.

Use these docs

Search with Cmd/Ctrl+K to find pages and sections, including commands and troubleshooting. Use Copy page for clean Markdown, Markdown for a machine-readable page, or Suggest an edit to propose a correction. The on-page contents links jump to a specific section.

For assistants and automation, start with Documentation for LLMs. For privacy questions, read Telemetry and Security. To contribute to the editor, follow Contributing.