fp-cloud-cli

# FailproofAI Cloud CLI `fp` is a command-line client for a FailproofAI Cloud deployment. It authenticates either as a signed-in **user** or with a scoped **API key** (§2), and every command takes `--json`, so it's built to be driven by an agent. ## 1. Find how to invoke it Resolve this once, then reuse it for every call: 1. If `fp` is on `PATH` (`command -v fp`) → use **`fp`** (it's installed via pipx / uv tool / pip). This is the normal case. 2. Else, if you're in (or under) a repo with an `fp-cloud-cli/` directory containing the `fp_cli` package → run it from there with **`uv run fp`** (a local dev build). The first run after a code change prints `Building…`/`Installed…` on stderr — that's `uv`, not CLI output; ignore it. 3. Else the CLI isn't available here → tell the user to install it (`pipx install fp-cloud-cli` or `uv tool install fp-cloud-cli`) and stop. Don't try to reach the dashboard another way. Don't go spelunking in the CLI source tree for flags — if you're unsure of one, run `fp <group> <cmd> --help`. The source is not the documented contract and reading it wastes effort. Throughout this skill, `fp` means "whichever form you resolved." ## 2. The contract (the CLI enforces it, work with it, don't fight it) - **Global options go BEFORE the command:** `fp --json events`, never `fp events --json`. Globals are `--base-url`, `--org`, `--token`, `--api-key`, `--json`, `--insecure`/`--secure`. After the command they're a usage error. - ...