CLI

Sign in, check your account, and confirm your access from the terminal. Media transforms run through the @transform-kit/sdk — the CLI handles auth and diagnostics.

Install

npm install -g @transform-kit/cli

This installs two equivalent commands: transform-kit and the short alias tk. Node 20+.

Log in

Authenticate through your browser. The CLI opens the dashboard, you approve the session, and the token is saved to ~/.transform-kit/config.json — no key to copy or paste.

tk login
# Opens your browser → approve → done.

tk whoami
# { "user_id": "…", "key": { "name": "…", "source": "cli" } }

Check your access

tk whoami confirms your session. tk health pings the API with no auth.

tk whoami
tk health           # { "status": "ok" }

Command reference

• tk login — authenticate via the browser (flags: --issuer, --api-url for local dev).
• tk logout — clear the stored token.
• tk whoami — show the authenticated account and key.
• tk health — check API availability (no auth).

Local development

Point the CLI at a local stack with environment variables:

export TK_ISSUER=https://transform-kit.localhost
export TK_API_URL=https://api.transform-kit.localhost
tk login