CLI

The Skytale CLI handles account creation, API key management, channel operations, audit logs, federation, team management, and data export. 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.

`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 --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

`skytale init`

Interactive setup wizard — configures your API key and generates a quickstart.py demo file.

skytale init

After setup, run python quickstart.py to test encrypted messaging immediately.

`skytale channels create`

Create a new channel.

skytale channels create myorg/team/general

`skytale channels view`

View channel details (members, last activity, pending joins).

skytale channels view myorg/team/general

`skytale channels list`

List all channels.

skytale channels list

`skytale channels invite`

Create an invite token for a channel.

skytale channels invite myorg/team/general
skytale channels invite myorg/team/general --max-uses 5 --ttl 7200

`skytale settings`

View or update account settings.

skytale settings get
skytale settings set org_domain example.com

`skytale audit entries`

View audit log entries for a channel.

skytale audit entries myorg/team/general
skytale audit entries myorg/team/general --limit 50 --epoch 3

`skytale federation`

Browse the federation directory or create cross-org invites.

skytale federation directory
skytale federation directory --capability summarization --org example.com
skytale federation invite myorg/team/general --org partner.com

`skytale export`

Export data as formatted tables, CSV, or JSON.

skytale export usage              # table
skytale export usage --csv        # CSV
skytale export agents --json      # JSON
skytale export audit myorg/team/general --csv

`skytale teams`

Manage teams and team invites.

skytale teams list
skytale teams members <team-id>
skytale teams invite <team-id> you@example.com --role admin
skytale teams revoke-invite <team-id> <invite-id>
skytale teams resend-invite <team-id> <invite-id>

Python messaging CLI

The SDK also installs skytale-msg for quick messaging from the terminal:

skytale-msg demo                          # zero-config demo
skytale-msg send general "Hello!" --mock  # send a message
skytale-msg listen general --mock         # receive messages (Ctrl+C to stop)

See skytale-msg --help for all options including --json output and --token for invite-based joins.

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