# Documentation Home

Locus is the unified AI engineering interface for GitHub teams: one CLI to plan, execute, review, and ship code across Claude and Codex.

## Getting Started

If you are new to Locus, follow these pages in order:

1. [Installation](https://docs.locusai.dev/getting-started/installation) -- install Locus, `gh`, and one AI provider CLI.
2. [Sandboxing Setup](https://docs.locusai.dev/getting-started/sandboxing-setup) -- set up Docker-based isolation for safe AI execution.
3. [Quickstart](https://docs.locusai.dev/getting-started/quickstart) -- run one complete end-to-end workflow.

You can reach a working flow by following only those three pages.

## Who This Is For

* Engineering teams already using GitHub Issues, Milestones, labels, and PRs as their delivery workflow.
* Teams that want one operational interface across Claude and Codex instead of provider-specific process.
* Developers who want built-in planning, execution, review, iteration, and status workflows in one CLI.
* Teams that want full-auto execution with Docker sandbox isolation and GitHub-native auditability.

## What Locus Is Not

* Not a replacement for GitHub. GitHub is the system of record.
* Not a hosted SaaS backend. Locus runs locally and uses `gh` for GitHub operations.
* Not "just model access". Locus provides orchestration workflows on top of provider CLIs.
* Not one-click magic. Automation is explicit and configurable (`autoLabel`, `autoPR`, `run --resume`).

## Core Strengths

1. [**Unified interface across AI clients**](https://docs.locusai.dev/core-strengths/unified-interface) -- switch models and providers without changing your workflow commands.
2. [**GitHub-native operational memory**](https://docs.locusai.dev/core-strengths/github-backend) -- issues, milestones, labels, and PRs are the entire data plane. No external database.
3. [**Built-in orchestration tools**](https://docs.locusai.dev/core-strengths/overview) -- `plan`, `run`, `review`, `iterate`, `status`, and `logs` go beyond what raw provider CLIs offer.
4. [**Safe automation via auto-approval mode**](https://docs.locusai.dev/core-strengths/auto-approval-mode) -- full-auto execution with Docker sandbox isolation, resumable runs, and configurable safeguards.

## What You Will Learn Next

The [Quickstart](https://docs.locusai.dev/getting-started/quickstart) walks through:

1. Switching between Claude and Codex using the same command surface.
2. Creating and executing GitHub-native sprint work.
3. Running built-in `plan -> run -> review -> iterate` workflows.
4. Enabling automation settings and resuming interrupted execution.

After that, dive deeper into:

1. [How Locus Works](https://docs.locusai.dev/workflow-deep-dives/how-it-works)
2. [Execution Model](https://docs.locusai.dev/workflow-deep-dives/execution-model)
3. [Sprints and Issues](https://docs.locusai.dev/workflow-deep-dives/sprints-and-issues)
4. [Built-In Tools](https://docs.locusai.dev/core-strengths/overview)
5. [Auto-Approval Mode](https://docs.locusai.dev/core-strengths/auto-approval-mode)