# Atlas

> Atlas is a model-agnostic, terminal-native AI coding agent. Plan, edit, and ship from the place you already live: your shell.

2294 pages across 10 sections.
This file is an index. Page listings live in the per-section files linked below.

## Machine-readable (markdown, no HTML to parse)
- [Install, configure, and run Atlas (full documentation)](https://runatlas.sh/docs.md)
- [Every command, flag, type, and default (generated from the CLI itself)](https://runatlas.sh/cli-reference.md)
- [Providers, env variables, and where to get an API key](https://runatlas.sh/models.md)
- [Common errors, their causes, and the exact fix (match a pasted error here)](https://runatlas.sh/errors.md)
- [Definitions of every Atlas term (Shipped, Promised, Ledger, Axis, Airlock, ...)](https://runatlas.sh/vocabulary.md)
- [Every feature, including the eight record engines](https://runatlas.sh/features.md)
- [How Atlas compares to Claude Code, Codex, Cursor, and Aider](https://runatlas.sh/comparisons.md)
- [Full pricing: plans, comparison matrix, and FAQ](https://runatlas.sh/pricing.md)
- [What Atlas is, and the principles behind it](https://runatlas.sh/about.md)
- [Integration registry with evidence and vendor-recognition status](https://runatlas.sh/integrations.json)
- [Security controls, deployment boundaries, and current assurance status](https://runatlas.sh/security.json)

## Core pages
- [Home](https://runatlas.sh/)
- [Docs](https://runatlas.sh/docs)
- [Pricing](https://runatlas.sh/pricing)
- [About](https://runatlas.sh/about)
- [Resources](https://runatlas.sh/resources)
- [Help Center](https://runatlas.sh/help)
- [Security and Trust](https://runatlas.sh/security)
- [Integrations](https://runatlas.sh/integrations)

## Sections
Each section is a separate file listing its pages with descriptions. Fetch the
ones you need. They are ordered by intent, highest first.

- [Features](https://runatlas.sh/llms/feature): 33 pages
- [Comparisons](https://runatlas.sh/llms/comparison): 49 pages
- [Alternatives](https://runatlas.sh/llms/alternative-to): 54 pages
- [Troubleshooting](https://runatlas.sh/llms/troubleshooting): 105 pages
- [Models and providers](https://runatlas.sh/llms/model-provider): 274 pages
- [Integrations](https://runatlas.sh/llms/integration): 59 pages
- [Workflows](https://runatlas.sh/llms/workflow): 21 pages
- [Languages](https://runatlas.sh/llms/language): 72 pages
- [Use cases](https://runatlas.sh/llms/use-case): 347 pages
- [Workflow by language](https://runatlas.sh/llms/stack): 1280 pages

## Key facts
- Terminal-native TUI; runs in your shell as a single binary, no GUI required.
- Plans before edits: drafts a plan in a read-only plan agent, then asks before implementing.
- Every tool call is permission-gated (allow / ask / deny); every edit is a unified diff you approve.
- Hybrid semantic + keyword code search fused with reciprocal rank fusion; AST chunking via tree-sitter.
- Can index code with local Ollama embeddings, keeping source off third-party servers.
- Extensible with plugins and Model Context Protocol (MCP) servers.
- Free core; switch model and provider on the fly.
- Eight record engines, named: Shipped (free), Promised, Ledger, Minutes, Brief, House, Upkeep, Map. Defined at /vocabulary.md.

## Install
```sh
curl -fsSL https://runatlas.sh/install | sh
```