> ## 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.

# Quickstart

> Get up and running with Aether in under 5 minutes

# Quickstart

Get from zero to a running AI agent in under 5 minutes.

## Step 1: Create an Account

<Tabs>
  <Tab title="Web">
    Navigate to [app.runaether.dev](https://app.runaether.dev) and sign up with your email.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    # Install the CLI
    brew install pranav100000/aether/aether

    # Log in to your account
    aether auth login
    ```
  </Tab>
</Tabs>

## Step 2: Add an API Key

Aether uses your own AI provider keys (BYOK). Add at least one:

<Tabs>
  <Tab title="Web">
    Go to **Settings → API Keys** and add your provider key (Anthropic, OpenAI, or OpenRouter).
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    aether apikey add --provider anthropic --key sk-ant-...
    ```

    Supported providers: `anthropic`, `openai`, `openrouter`
  </Tab>
</Tabs>

## Step 3: Create a Project

<Tabs>
  <Tab title="Web">
    Click **New Project** from the dashboard and give it a name.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    aether project create --name "my-first-project"
    ```
  </Tab>
</Tabs>

## Step 4: Run Your First Task

<Tabs>
  <Tab title="Web">
    Open your project and type a prompt in the chat:

    > Create a Next.js app with a landing page that has a hero section and a features grid

    The agent will start working — writing code, installing dependencies, and starting the dev server.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    aether run "Create a Next.js app with a landing page that has a hero section and a features grid"
    ```

    The agent's output streams to your terminal in real-time.
  </Tab>
</Tabs>

## Step 5: Preview Your App

Once the agent starts a dev server, a preview URL appears automatically:

```
https://3000-abc12345.preview.runaether.dev
```

Click it to see your running application — hot module replacement works through the proxy.

## What's Next?

<CardGroup cols={2}>
  <Card title="Core Concepts" icon="book" href="/concepts">
    Learn about projects, workspaces, tasks, and the agent
  </Card>

  <Card title="Using the Agent" icon="robot" href="/guides/ai-agent">
    Understand what the agent can do and how to get the best results
  </Card>

  <Card title="GitHub Integration" icon="github" href="/guides/github-integration">
    Import repos and push changes back to GitHub
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli/overview">
    Full command reference for the Aether CLI
  </Card>
</CardGroup>