# Caraer CLI

The Caraer CLI (`caraer-cli`) is the downloadable developer tool for managing
Caraer apps, webhooks, serverless functions, schedules, inbound routes, and
local developer projects.

## Install


```bash
pipx install caraer-cli
# or from a local checkout:
pip install -e ".[dev]"
```

## Core workflows


```bash
caraer auth login --email you@example.com
caraer company select <company-uuid>
caraer apps init --label "My Sync App"
cd my_sync_app
caraer apps add function sync-handler
caraer apps add schedule renew-watch --function sync-handler
caraer apps add inbound provider-push --function sync-handler
caraer apps push --deploy
caraer apps local logs
caraer apps local dev
caraer sandbox create --name my-sandbox
```

Developer project mutations require the **app creator company** (or super-admin).
Knowing an app UUID alone is not authorization.

Typed serverless payloads live in the Caraer clients (`@caraer/client` /
`caraer-client`).

## Related

- Tutorial: [How to create a Caraer app](/blog/2026-08-23-how-to-create-a-caraer-app)
- [Serverless functions in Caraer apps](/blog/2026-03-25-serverless-functions-in-caraer-apps)
- Source: `caraer-cli` repository
- Platform APIs: Caraer Java Backend (`/api/v2/apps`, installation runtime, developer-projects)
- Runtimes: `nodejs22`, `python312` on Google Cloud Functions (V2: one container per app)