# Troubleshooting

The quickest fixes for the problems people hit most.

## `/appling` or `$appling` isn't recognized

- Start a **new** session. Commands are loaded when a session starts.
- Check **Settings → General → AI Tools**. It should say Ready. If it says Not connected or Update available, click the button next to it.
- If it mentions Command Line Tools, install them from the welcome screen (**Settings → General → AI Tools → Show Welcome…**).

## An app won't start

Open the **Output** tab. It shows what the app printed, with error lines in red, and **First Error** jumps to the first one. **Send Error to Claude Code** (or Codex) hands the end of the output to your AI tool.

Common causes:

- **A command isn't found.** Appling starts apps with the same settings as your terminal. If you installed Node or Python after opening Appling, quit and reopen it.
- **The port is in use.** Appling normally warns first. See the Ports page for what holds it.
- **Dependencies aren't installed.** Run the install step once, or ask your AI tool to add it to the start script.

## It says "Folder missing"

The project folder was moved or deleted. Click **Relink…** and choose where it is now.

## The address button doesn't appear

The button appears when the app is listening on a port. If the app doesn't serve a web page (a script, a worker), there is no address, and that's expected.

## Continue in Claude Code does nothing

Claude Code needs to be installed and on your path. Check that `claude` runs in your terminal. The terminal Appling uses is set in **Settings → General → Apps**.

## I entered my key and it was refused

- "Already in use on as many Macs as it allows": open Appling on a Mac you no longer use and choose **Settings → License → Deactivate This Mac**, or buy another license.
- "Couldn't reach the license server": activation needs an internet connection once.

## Where Appling keeps things

- Your list: `~/Library/Application Support/Appling/projects.json`
- Safety copies of that list: the `Safety Copies` folder next to it. Restore one in **Settings → Safety Copies**.
- Logs of the last three runs of each app: `~/Library/Logs/Appling`

## Still stuck

Write to [support](/support/) with your Appling version (Appling → About), your macOS version, and what you expected to happen.
