# Connect Codex

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

## Add the command

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

Start a new Codex session afterwards.

## Save a project

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

```
$appling
```

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

If the app needs a command to start and has no start script yet, Codex shows you the command and asks before creating one.

## Continue later

Open the appling and click **Continue in Codex**. Appling opens that session in the Codex app.

If an appling has no saved session yet, the button reads **Open in Codex** and starts Codex with a short description of the project.
