runapi-clilisted
Install: claude install-skill runapi-ai/cli-skill
# RunAPI CLI
The `runapi` CLI executes one-off artifacts or results only for services in its
installed command catalog. An app, backend, worker, library, or production code
integration uses a RunAPI SDK instead.
## Choose route
Use the CLI for a one-off artifact or result. Use an SDK for an app, backend,
worker, library, or production code. Before composing a service command,
discover the installed command catalog with `runapi --help`; proceed only when
it lists the service. An absent service routes to its SDK or public API contract,
not to a guessed CLI command.
## Install
| Target | Command |
|---|---|
| macOS / Linux (interactive) | `brew install runapi-ai/tap/runapi` |
| Server / CI (headless) | `curl -fsSL https://runapi.ai/cli/install.sh \| sh` |
The installer detects OS and architecture (Linux and macOS, amd64 and arm64), verifies a SHA-256 checksum from `https://runapi.ai/cli/latest.json`, and refuses to write the binary if verification fails.
## Authentication
Check the current state first:
```shell
runapi auth status
```
| Source | How |
|---|---|
| Environment (agent/headless default) | Read `RUNAPI_API_KEY` from the environment |
| Saved config (agent/server/CI) | `printf '%s' "$RUNAPI_API_KEY" \| runapi auth import-token --token -` (writes `~/.config/runapi/config.json` with mode 0600) |
| Browser login (interactive fallback) | `runapi login` in a terminal, or the MCP `login` tool from an MCP host |
`RUNAPI_BASE_URL` overrides the default base URL.
Th