Docs / Getting started
Getting started
From download to your first running appling takes a few minutes. This page walks through it.
1. Install
- Download Appling and open the file.
- Drag Appling into your Applications folder and open it.
- 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 ⌘K to find any appling by name, folder, branch or port.
- Read Start scripts and ports if an app doesn’t start the way you expect.
Last updated November 15, 2026