The local app (setup app)

On this page

The setup app is the platform’s desktop companion for macOS, Windows, and Linux. Get it from the download page.

Signing in

After starting the app, sign in with your Application Platform account. The app then loads your organizations and projects.

The three areas

Projects

Select a project and clone it: all repositories of the project are cloned into your workspace folder (default: ~/Documents/application-platform) or updated.
The app sets up everything else automatically: the ap CLI, the Git pre-commit hook, symlinks for the shared IDE/AI configuration from local-configuration, and the platform extension for VS Code, Cursor, and Antigravity.
Open the project in your tool: with one click in the IDE or AI tool of your choice. Change the default tool in the settings – see Choose your program.

Developer setup

Checks your machine and installs missing tools – from Git and runtimes (Node, Flutter, Java, …) to IDEs and AI tools. The full list is in Requirements. Each entry shows its status; install tools individually or all at once.

Settings

Choose the default tool for opening projects (e.g. VS Code).
Configure your Git identity (name, email) and credentials.
Open the workspace folder, copy its path, check versions of app, CLI, and extension.

Warning

On a Mac, don’t place your workspace folder inside an iCloud-synced folder – the app warns about this because syncing can break Git repositories and symlinks.

Updates

The app checks for new versions itself and offers the download. The ap CLI also keeps itself up to date (ap cli-update check).