# Getting started

Source: https://athas.dev/docs

Install Athas, open a project, and choose the guides for your development workflow.

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](https://athas.dev/docs/installation) 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](https://athas.dev/docs/command-palette) with `Cmd/Ctrl+Shift+P` to discover actions.
5. Show the [terminal](https://athas.dev/docs/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](https://athas.dev/docs/quick-open), [Editing](https://athas.dev/docs/editing), [Search](https://athas.dev/docs/search)                             |
| Get completions, symbols and errors | [Language servers](https://athas.dev/docs/language-servers), [Diagnostics](https://athas.dev/docs/diagnostics), [Formatting](https://athas.dev/docs/formatting) |
| Review and commit a change          | [Git](https://athas.dev/docs/git-integration), [Diffs](https://athas.dev/docs/git-diff), [Worktrees](https://athas.dev/docs/git-worktrees)                      |
| Use an AI coding agent              | [AI overview](https://athas.dev/docs/ai), [Athas Agent](https://athas.dev/docs/athas-agent), [External agents](https://athas.dev/docs/external-agents)          |
| Work across machines                | [Remote connections](https://athas.dev/docs/remote), [WSL](https://athas.dev/docs/wsl)                                                         |
| Inspect data                        | [Database viewer](https://athas.dev/docs/database-viewer)                                                                     |
| Change my setup                     | [Settings](https://athas.dev/docs/settings), [Themes](https://athas.dev/docs/themes), [Keymaps](https://athas.dev/docs/keymaps), [Vim](https://athas.dev/docs/vim)               |
| Share work                          | [Share to Web](https://athas.dev/docs/sharing), [Collaboration](https://athas.dev/docs/collaboration)                                          |
| Fix a problem                       | [Troubleshooting](https://athas.dev/docs/troubleshooting), [Updates](https://athas.dev/docs/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](https://athas.dev/pricing) for current plans and [Enterprise controls](https://athas.dev/docs/enterprise) 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](https://athas.dev/docs/for-llms).
For privacy questions, read [Telemetry](https://athas.dev/docs/telemetry) and [Security](https://athas.dev/security).
To contribute to the editor, follow [Contributing](https://athas.dev/docs/contributing).