CommandsProjects

skytells projects ls

List all Skytells projects you have access to, with optional type filtering and JSON output.

Overview

skytells projects ls lists all projects associated with your authenticated account. Projects are the top-level organizational boundary — every app, database, domain, and environment variable belongs to a project.

This command requires user authentication (skytells login) but does not require a linked project access key, since it operates at the account level.

Syntax

skytells projects ls [--type <type>] [--json]

Flags

FlagDescription
--type <type>Filter results by project type (e.g. production, staging).
--jsonOutput as JSON.

Examples

# List all projects
skytells projects ls

Example output:

┌──────────┬──────────────┬────────────┬──────────────────┐
│ ID       │ Name         │ Type       │ Created          │
├──────────┼──────────────┼────────────┼──────────────────┤
│ abc123   │ my-project   │ production │ 2026-01-15       │
│ def456   │ staging      │ staging    │ 2026-02-01       │
└──────────┴──────────────┴────────────┴──────────────────┘
# Filter by type
skytells projects ls --type staging

# JSON output for scripting
skytells projects ls --json

# Extract project IDs
skytells projects ls --json | jq -r '.[].id'

# Find a project by name
skytells projects ls --json | jq -r '.[] | select(.name == "my-project") | .id'

After listing

Once you have a project ID, copy its access key from the Console and link it:

skytells link sk_proj_your_access_key

Then verify the linked project:

skytells project

How is this guide?

logout / whoami / link

End your CLI session, verify the active identity, and link a project access key.

create / update

Create a new project, view the linked project, and update project settings from the CLI.

On this page

Overview
Syntax
Flags
Examples
After listing