CLI

The Skytale CLI handles account creation, API key management, and JWT token exchange. It replaces the curl commands you’d otherwise run against the API.

Install

Build from source:

cd cli && cargo build --release
cp target/release/skytale ~/.cargo/bin/   # or anywhere on your PATH

Verify:

skytale --help

Commands

`skytale signup`

Create an account and save the API key automatically.

skytale signup [email protected]
skytale signup [email protected] --name "Your Name"

The API key is saved to ~/.skytale/api-key (mode 0600). All subsequent commands use it automatically.

`skytale account`

Show the current account info.

skytale account

ID:    550e8400-e29b-41d4-a716-446655440000
Email: [email protected]
Name:  Your Name
Plan:  free

`skytale keys list`

List all active API keys.

skytale keys list

ID                                     PREFIX             NAME         CREATED
550e8400-e29b-41d4-a716-446655440000   sk_live_a1b2c3d4   default      2026-02-26 14:30

`skytale keys create`

Create a new API key.

skytale keys create --name ci-key

`skytale keys revoke`

Revoke an API key by ID.

skytale keys revoke 550e8400-e29b-41d4-a716-446655440000

`skytale token`

Exchange the API key for a short-lived JWT. Prints the raw token to stdout.

skytale token

eyJhbGciOiJIUzI1NiIs...

Useful for piping into other tools:

export SKYTALE_JWT=$(skytale token)

`skytale billing`

Show current plan and subscription status.

skytale billing

Plan:   pro
Status: active
Renews: 2026-04-01T00:00:00Z

`skytale billing upgrade`

Subscribe to a paid plan. Opens Stripe Checkout in your browser.

skytale billing upgrade pro    # $29/mo
skytale billing upgrade team   # $99/mo

`skytale billing portal`

Open the Stripe billing portal to update payment methods, view invoices, or cancel.

skytale billing portal

Configuration

Setting	Flag	Env var	Default
API URL	`--api-url`	`SKYTALE_API_URL`	`https://api.skytale.sh`
API key	—	`SKYTALE_API_KEY`	`~/.skytale/api-key`

Precedence: flag > env var > file/default.

Self-hosted

Point the CLI at your own API server:

skytale signup [email protected] --api-url http://localhost:3100

Or set it globally:

export SKYTALE_API_URL="http://localhost:3100"
skytale keys list