> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Concepts

> The building blocks of Aether and how they fit together

Aether binds a handful of concepts together by a single rule: **one task = one agent = one workspace VM**. Everything below hangs off that.

<CardGroup cols={2}>
  <Card title="Projects" icon="folder" href="/concepts/projects">
    The top-level container for your code, environment, GitHub link, and per-project task defaults.
  </Card>

  <Card title="Workspaces" icon="cloud" href="/concepts/workspaces">
    The isolated Linux VM where a task's agent reads, runs, and tests your code.
  </Card>

  <Card title="Tasks & Lifecycle" icon="list-check" href="/concepts/tasks-and-lifecycle">
    A unit of agent work, bound to one workspace, that moves through queued → processing → awaiting input.
  </Card>

  <Card title="Agents & Models" icon="robot" href="/concepts/agents-and-models">
    The four selectable providers — Codex (default), Claude Code, OpenCode, Cursor — and the model each runs.
  </Card>

  <Card title="Billing & Credits" icon="credit-card" href="/concepts/billing-and-credits">
    Usage is metered in credits, where credits track VM runtime. Tokens are reported but never billed.
  </Card>

  <Card title="Integrations" icon="plug" href="/concepts/integrations">
    GitHub, Sentry, Linear, and Slack connections that let the agent work with your repos, errors, issues, and notifications.
  </Card>
</CardGroup>

## How they fit together

You create a **project** (optionally linked to a GitHub repo) and start a **task** with a prompt. Aether provisions one isolated **workspace** VM and runs one **agent** inside it. The agent works until it finishes a turn or needs your input; you respond and it resumes. The VM's runtime is metered in **credits**. **Integrations** let the agent pull context (issues, errors) and push results (pull requests, notifications) to the tools you already use.