---
title: Quickstart
description: From an invitation to a reviewed change, and back again, in eight steps.
canonical_url: https://lookout.arcadia.is/docs/quickstart
type: quickstart
section: Get started
last_updated: 2026-11-16
related:
  - https://lookout.arcadia.is/docs
  - https://lookout.arcadia.is/docs/checkpoints
  - https://lookout.arcadia.is/docs/models
---

> Every page of these docs: https://lookout.arcadia.is/llms.txt

# Quickstart

From an invitation to a reviewed change, and back again, in eight steps.

You need an invitation and a Mac with Apple silicon. Each step ends with something you can see.

## 1. Get an account

1. Open your invitation link. It fills in your invitation code. Without a link, open
   [Create account](https://accounts.arcadia.is/signup?client=lookout-web) and enter the code in **Invitation code**.
2. Enter your **Email**, then the six-digit code mailed to it, then a **Username** (3 to 32 characters: letters,
   numbers, `_` and `-`), each on its own screen.
3. Choose a **Password** of at least 12 characters and click **Create account**.

Your dashboard opens.

## 2. Install the Mac app

1. Click **Download** at the top of the page (on a phone, in the menu on your picture), then click **Download** on
   the page it opens.
2. Open the disk image and drag Lookout into Applications.
3. Before the first launch, run this once in Terminal:

   ```sh
   xattr -cr /Applications/Lookout.app
   ```

4. Open Lookout from Applications.

The window shows **Lookout** and **Sign in**.

## 3. Sign in

1. Click **Sign in**. Your browser opens Lookout's sign-in page.
2. Sign in there with your email or username and your password. If this browser is already signed in, click
   **Continue**.
3. If your browser asks to open Lookout, allow it. The app picks up the sign-in by itself, and the page says
   **You're signed in**.
4. On a new account, this first Mac shows **Save your Recovery Key**. Save it as
   [Account and devices](https://lookout.arcadia.is/docs/account#recovery-key) shows, or click **Later**.

The window shows **Connect a provider**.

> [!NOTE]
> If your account already has another device, the app shows **Add this Mac** with a code. Enter the code on that
> device to add this Mac. With no other device at hand, [use your Recovery Key](https://lookout.arcadia.is/docs/account#use-recovery-key).
> When a provider you signed in to is already connected here, the app skips **Connect a provider** and opens on
> **New chat**.

## 4. Connect a provider

**Connect a provider** lists every provider: a free tier that needs no sign-in under **Connected**, so a chat can
already run, and the providers you can sign in to under **Available**.

1. To run on a plan you have, click the sign-in on that provider's row under **Available**: it names what you hold
   there, or says **Add API key** for a key. Finish the step on the provider's page, which opens with it: a page in
   your browser, a code, a key to paste, or another app's sign-in. The provider moves to **Connected**.
2. Click **Continue**. With only the free tier connected, it reads **Continue with the free tier**. If the free tier's
   row says the provider refuses Lookout's client, connect another provider first.

The app opens on **New chat**, and the connected providers' models are in the model menu. To connect one later, open
**Settings › Providers**, or click the settings glyph at the foot of the model menu's rail in the message box.
[Models and providers](https://lookout.arcadia.is/docs/models#connect) covers each provider's sign-in.

## 5. Open a project

1. Click the project picker above the message box.
2. Click **Open folder** (`⇧⌘O`), choose a folder with code in it, and click **Open**.

The picker shows the folder's name. A worktree or clone of a project you already have opens in that project, and the
checkout's name shows beside it ([Open a folder](https://lookout.arcadia.is/docs/chats#open-folder)).

## 6. Send a prompt

Type a task in the message box and press `Enter`. For example:

```text
Find one function in this project that has no tests, write tests for it, and run them.
```

The agent's steps stream into the chat as it reads files and runs commands. When it is done, a card shows how many
files changed.

## 7. Review the change

1. Click **Review** on the changes card. The side pane opens beside the chat on its **Changes** tab, with a diff for
   each file.
2. Use the scope menu at the top of the tab to switch between **This turn**, **This chat** and **Uncommitted**.

Each changed file shows its added and removed lines. `⇧⌘R` opens and closes the pane from anywhere in the chat.

## 8. Restore a checkpoint

Lookout records your files before every turn, in a git history of its own that leaves your repository alone.

1. In the row of buttons under the agent's answer, click **Restore files to before this turn**.
2. The dialog lists the files that change. Click the button that names their count, such as **Restore 2 files**.

The files are back to how they were before the turn, and a message such as **Restored 2 files** appears. Click
**Undo** in it to bring the change back.

## Next steps

- [Chats and projects](https://lookout.arcadia.is/docs/chats): queue, steer and stop the agent while it works.
- [Modes](https://lookout.arcadia.is/docs/modes): ask without edits, or split the work with Multitask.
- [Checkpoints and changes](https://lookout.arcadia.is/docs/checkpoints): revert one file, a turn or a whole chat.
- [Worktrees](https://lookout.arcadia.is/docs/worktrees): give a chat its own branch.

Prefer a terminal? The [CLI](https://lookout.arcadia.is/docs/cli) runs the same agent with `lookout exec`.

## Related

- [Overview](https://lookout.arcadia.is/docs.md): Lookout runs coding agents in your projects, on the model plans you sign in to, from a Mac app or a terminal.
- [Checkpoints and changes](https://lookout.arcadia.is/docs/checkpoints.md): Lookout records the chat's folder before every turn, so you can review what the agent changed and put files back.
- [Models and providers](https://lookout.arcadia.is/docs/models.md): Connect the providers you have a plan with or add a custom provider, then pick a model, its effort and its variant for each chat.
