skytells logout · whoami · link

skytells logout

Removes stored credentials from ~/.config/skytells/credentials.json. After logging out, all commands that require authentication will fail until you run skytells login again.

Syntax

skytells logout [--force]

Flags

Examples

# Logout with confirmation prompt
skytells logout

# Logout immediately, no prompt
skytells logout --force

skytells whoami

Displays your current authenticated identity — user ID, name, and authentication status. Use this to confirm which account is active, or to verify that environment variable auth is working correctly in a CI context.

Syntax

skytells whoami [--json]

Flags

Examples

# Check current identity
skytells whoami

# In a script — parse the user ID
skytells whoami --json | jq -r '.id'

skytells link

Links a project access key to your local session. Project access keys (sk_proj_*) scope all subsequent project-scoped commands — apps, databases, deployments, environment variables, and domains — to a specific project.

You must run skytells link before using any resource-level command. Authentication alone (skytells login) is not sufficient for project-scoped operations.

Syntax

skytells link <access-key>

Arguments

Where to find your access key

1. Open console.skytells.ai and select your project — see Projects
2. Go to Settings
3. Copy the access key

Access keys can also be set via environment variable SKYTELLS_ACCESS_KEY, which takes precedence over the stored key. See Configuration.

Examples

# Link a project
skytells link sk_proj_abc123xyz

# Verify the linked project
skytells project

Switch projects

To switch to a different project, run skytells link again with the new access key:

skytells link sk_proj_other_project_key

In scripts managing multiple projects, override the key per-invocation:

SKYTELLS_ACCESS_KEY=sk_proj_project_one skytells apps ls
SKYTELLS_ACCESS_KEY=sk_proj_project_two skytells apps ls