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 you@example.com
skytale signup you@example.com --name "Your Name"

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

Caution

The full API key is only shown once at signup. It’s saved to disk, but if you delete ~/.skytale/api-key without backing it up, you’ll need to create a new key.

skytale account

Show the current account info.

skytale account

ID:    550e8400-e29b-41d4-a716-446655440000
Email: you@example.com
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
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)

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 you@example.com --api-url http://localhost:3100

Or set it globally:

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