---
title: "Install and set up Panolayer"
description: "Install Panolayer, sign in, and open your own repository. You’ll finish with a visual architecture of your code and verification results you can explore."
url: https://panolayer.com/docs/getting-started
type: HOW-TO
updated: 2026-10-21
---

# Install and set up Panolayer

Install Panolayer, sign in, and open your own repository. You’ll finish with a visual architecture of your code and verification results you can explore.

Last updated 2026-10-21

<a id="before-you-start"></a>

## Before you start

Follow along with your own codebase. We’ll use screenshots of the **Twitter Clone** example to explain what you’re seeing in Panolayer.

- **An Apple silicon Mac** running **macOS 15 Sequoia or later**. Intel Macs are not supported.
- **An internet connection** to download Panolayer and sign in.
- **A local copy of your Git repository.** If it’s only on a hosting service such as GitHub, clone it to your Mac first using your usual Git tools.

You can check your Mac’s chip and macOS version in **Apple menu → About This Mac**.

**Start with Panolayer Agent.** It’s built in and is the agent we’ll use for your first bug fix. You can also use any other supported agent after installing it. See [Supported agents](/docs/agents) for setup.

<a id="install-panolayer"></a>

## Install Panolayer

1. [Download Panolayer](/download?download_source=docs-getting-started-install&from_path=%2Fdocs%2Fgetting-started) for Mac.
2. Open the downloaded **.dmg** file.
3. Drag **Panolayer** into **Applications**.
4. Open **Panolayer** from Applications.

On the welcome screen, choose **Get started** to begin setup.

<a id="sign-in"></a>

## Sign in

Start signing in from the Panolayer app. You’ll finish in your browser, then return to the app.

1. Choose **Create an account** if you’re new to Panolayer, or **Sign in** if you already have an account.
2. Choose **Continue with GitHub**, **Continue with Google**, or email. Panolayer opens your browser.
3. Finish signing in on **panolayer.com**. Check that you’re using the account you want to use in the app.
4. Compare the code in your browser with **Your code** in Panolayer. When they match, choose **Yes, sign in on this computer** in the browser.
5. When the browser confirms you’re signed in on the app, return to **Panolayer**.

<a id="system-check"></a>

## Complete the system check

Panolayer checks that your Mac has Git, which it uses to track changes and keep agents working in separate workspaces. If the required tools are already installed, Panolayer skips this step.

If you see **One quick system check**:

1. Choose **Install** next to **Git — Apple Command Line Tools**.
2. Complete Apple’s installer. This may take a few minutes.
3. Return to Panolayer. It detects the installed tools automatically.
4. When the check is ready, choose **Choose a project**.

## Continue learning

- [Open your first project](/docs/open-your-first-project)

- [Fix your first bug with Panolayer](/docs/first-bug)

- [Explore architecture and dependencies](/docs/architecture)

- [Supported agents](/docs/agents)
