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

Web

Navigate to app.runaether.dev and sign up with your email.

CLI

# Install the CLI
brew install pranav100000/aether/aether

# Log in to your account
aether auth login

Step 2: Add an API Key

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

Web

Go to Settings → API Keys and add your provider key (Anthropic, OpenAI, or OpenRouter).

CLI

aether apikey add --provider anthropic --key sk-ant-...

Supported providers: anthropic, openai, openrouter

Step 3: Create a Project

Web

Click New Project from the dashboard and give it a name.

CLI

aether project create --name "my-first-project"

Step 4: Run Your First Task

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.

CLI

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.

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?

Core Concepts

Learn about projects, workspaces, tasks, and the agent

Using the Agent

Understand what the agent can do and how to get the best results

GitHub Integration

Import repos and push changes back to GitHub

CLI Reference

Full command reference for the Aether CLI