# Connect Claude Code

Appling adds one command to Claude Code. It runs only when you type it.

## Add the command

Open **Settings → General → AI Tools** in Appling and click **Install** next to Claude Code (or use the welcome screen on first launch). This copies a small skill into `~/.claude/skills/appling`. It is updated with the app.

Start a new Claude Code session afterwards; running sessions don't pick up new commands.

## Save a project

In the Claude Code session where you built or changed something, type:

```
/appling
```

Claude collects the project's name, a short description, its folder, how it starts, its icon if it has one, and a one-line summary of what this session did. It then saves that to Appling. Nothing is saved unless you type the command.

If the app needs a command to start (for example `npm run dev`) and has no start script yet, Claude shows you the command and asks before creating one. You can keep the script in the project or in Appling's own folder.

## Continue later

Open the appling and click **Continue in Claude Code**. Appling opens your terminal in the project folder and resumes that exact session.

Each later session you save with `/appling` is added to the appling's **Sessions** tab, with the branch and commit at the time.

## If something is already there

If the folder is already in Appling, Claude asks whether to add this session to its history. If another project uses the same name in a different folder, Claude asks whether this is the same project moved, or a different one. It never overwrites the other project.
