@tillstack/cli 0.2.0

package/README.md

@@ -0,0 +1,57 @@
+# `tilldev` — the TillDev CLI
+
+Terminal parity with the dashboard: do most day-to-day work — across **TillPulse**
+(observability) and **TillAuth** (auth) — without leaving the shell. Anything the
+CLI does, the dashboard does too, and vice-versa.
+
+```
+npm i -g @tillstack/cli     # or: pnpm --filter @tillstack/cli build && npm link
+tilldev login
+tilldev pulse projects
+```
+
+## Auth
+
+The CLI stores its token at `~/.tilldev/config.json` (mode `0600`). A plain
+`login` saves a ~1h access token (it re-prompts on expiry). For CI, mint a
+long-lived API key and export it:
+
+```
+tilldev keys create ci --scopes read,write
+export TILLDEV_TOKEN=tp_…        # picked up automatically
+```
+
+## Commands
+
+```
+Account
+  login | logout | whoami
+  config get [key] | config set <api-url|org|project> <value>
+
+TillPulse (tilldev pulse …)
+  projects | projects create <name> --platform <ios|android|react-native|flutter|web>
+  project <id> | dsn rotate <id>
+  issues [--project <id>] [--limit <n>] | issue <id>
+  metrics [--project <id>] | alerts
+  releases create <projectId> <version> [--build --env --commit]
+  sourcemaps|proguard|dsym upload <projectId> --release <v> --file <path>
+  ask "<question>"                 # natural-language query over your telemetry
+
+TillAuth (tilldev auth …)
+  apps | apps create <name> | app <appId>
+
+Workspace
+  team | keys | keys create <name> [--scopes read,write,admin]
+```
+
+## Global flags
+
+| Flag | Env | Meaning |
+|---|---|---|
+| `--api-url <url>` | `TILLDEV_API_URL` | API base (default `https://tilldev.dev`) |
+| `--token <t>` | `TILLDEV_TOKEN` | Auth token / API key |
+| `--json` | | Raw JSON instead of tables (scriptable) |
+| `--help`, `-h` | | Usage |
+
+Colors auto-disable when piped or when `NO_COLOR` / `TILLDEV_NO_COLOR` is set, so
+`tilldev pulse issues --json | jq …` stays clean.