# Getting started

From download to your first running appling takes a few minutes. This page walks through it.

## 1. Install

1. Download Appling and open the file.
2. Drag Appling into your Applications folder and open it.
3. Paste your license key when asked. It's in the receipt email. After this once, Appling works offline.

## 2. Connect your AI tools

The welcome screen shows the AI tools it found on your Mac. Click **Connect** next to Claude Code or Codex to add Appling's command to that tool:

- In **Claude Code** the command is `/appling`.
- In **Codex** the command is `$appling`.

The command works in new sessions, so start a new one after connecting. If the welcome screen says Apple's Command Line Tools are missing, let it install them; the commands need them.

You can skip this and add things by hand. You can also come back to it later in **Settings → General → AI Tools**.

## 3. Add your first appling

There are three ways. Use whichever fits.

- **From an AI session:** in the session where you built something, type `/appling` (Claude Code) or `$appling` (Codex). The tool saves the project, how it starts, and a link back to that session.
- **By dropping it:** drag a project folder, an HTML file, a report, or a link onto Appling's window. Appling reads the folder, suggests how it starts, and shows you what it found before saving.
- **From a folder of projects:** choose **File → Add from Folder…**, pick a folder such as `~/code`, and tick the projects you want. Appling looks only inside the folder you pick, and only when you ask.

## 4. Start it

Select the appling and click **Start**. The Output tab shows what it prints, and the address appears as a button once it's listening. Click **Stop** when you're done.

Documents and links have **Open** instead of Start.

## What next

- Star the applings you use most. They appear in the menu bar, where you can start and stop them without opening the window.
- Press <kbd>⌘K</kbd> to find any appling by name, folder, branch or port.
- Read [Start scripts and ports](/docs/start-scripts-and-ports/) if an app doesn't start the way you expect.
