Appling Download

Docs / Troubleshooting

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 with your Appling version (Appling → About), your macOS version, and what you expected to happen.

Last updated November 15, 2026