ReferenceCLI commands
BetaYou are reading docs for the beta channel (
2.4.1-beta.1) — updated automatically on every beta release.Switch to stable →CLI commands
ak whoami
Show current AgentKit login and licensed kits
Show the currently authenticated account and the kits it is licensed for. Reads the local session token, then queries the registry for live entitlements.
Who it's for: Both: scripts gating installs on entitlement (--json) and users confirming who they are signed in as.
When to use it: To verify login state before installing a licensed remote kit.
What changes on disk: Read-only. Reads ~/.agentkit/auth/session.json (AGENTKIT_HOME overrides the base dir) and reads AGENTKIT_REGISTRY_URL (default: $AGENTKIT_REGISTRY_URL, then dev/staging https://staging.agentkit.best or release https://agentkit.best) to resolve entitlements. Unauthenticated machines report Authenticated: false and exit 0.
Usage
ak whoami [flags]Examples
ak whoami
ak whoami --json
ak whoami --registry-url https://staging.agentkit.bestFlags
| Flag | Description |
|---|---|
-h, --help | help for whoami |
--json | Emit machine-readable JSON (implies --no-interactive) |
--no-interactive | Disable interactive prompts (CI-safe) |
-q, --quiet | Suppress non-error output on stderr |
--registry-url string | AgentKit registry base URL (default: $AGENTKIT_REGISTRY_URL, then dev/staging https://staging.agentkit.best or release https://agentkit.best) |
-V, --verbose | Extra diagnostic output on stderr (loses to --quiet) |
-y, --yes | Assume yes for all prompts |
Output modes
| Mode | Behavior |
|---|---|
pretty | default on TTY (colors, ASCII markers) |
plain | auto when stdout piped or --no-interactive |
json | --json (single-object envelope, NDJSON-safe) |
Exit codes
| Code | Meaning |
|---|---|
0 | success |
1 | runtime error |
2 | invalid flags |
3 | user-cancel (SIGINT, prompt-cancel) |
Related commands
ak— AgentKit CLI