skytells projects add

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

Creates a new Skytells project. After creation, retrieve the project's access key from the Console and link it with skytells link.

Syntax

skytells projects add <name> [--type <type>] [--json]

Arguments

Argument	Description
`name`	Display name for the new project.

Flags

Flag	Description
`--type <type>`	Project type. Common values: `production`, `staging`.
`--json`	Output the created project as JSON.

Examples

# Create a project
skytells projects add my-project

# Create a staging project
skytells projects add staging-env --type staging

# Create and capture the ID
PROJECT_ID=$(skytells projects add my-project --json | jq -r '.id')

After creating a project, go to the project's Settings in the Console to copy the access key (sk_proj_*), then run skytells link <key> to activate it in your terminal.

skytells project

Displays detailed information about the currently linked project. Requires a linked access key — see Authentication.

Syntax

skytells project [--json]

Flags

Flag	Description
`--json`	Output as JSON.

Example output

Project: my-project
  ID:           abc123
  Type:         production
  Network Mode: public
  Description:  Production environment
  Created:      2026-01-15

skytells project set

Updates a setting on the linked project. Changes take effect immediately.

Syntax

skytells project set <field> <value> [--json]

Arguments

Argument	Description
`field`	The setting to update. See allowed fields below.
`value`	The new value.

Allowed fields

Field	Description	Example
`name`	Project display name	`"My Project"`
`description`	Project description	`"Production environment"`
`network_mode`	Network access mode	`public` or `private`

Examples

# Rename the linked project
skytells project set name "Renamed Project"

# Add a description
skytells project set description "Production API services"

# Restrict to private networking
skytells project set network_mode private

How is this guide?

skytells projects add · project · project set

On this page