Skip to main content
For installation and setup, see CLI. Use -o json or -o yaml with any command for machine-readable output. Run gitpod help or add --help to any command for details.

​
Environment commands

CommandDescription
gitpod environment listList your environments
gitpod environment create <repo-url>Create a new environment
gitpod environment start <id>Start an environment
gitpod environment stop <id>Stop an environment
gitpod environment delete <id>Delete an environment
gitpod environment ssh <id>SSH into an environment
gitpod environment ssh-configConfigure SSH for direct access
gitpod environment logs <id>View environment logs
gitpod environment keep-aliveKeep environment alive while a process runs

​
Partial environment IDs

Instead of typing full UUIDs, use any substring of an environment ID: 
# Full UUID
gitpod environment ssh 019194a6-f0b0-70a1-beae-99718c351b04

# Prefix
gitpod environment ssh 019194a6

# Any substring
gitpod environment ssh 70a1-beae
The CLI resolves the partial ID if it uniquely identifies an environment.

​
Port commands

CommandDescription
gitpod environment port listList open ports
gitpod environment port open <port>Open a port (supports --name)
gitpod environment port close <port>Close a port

​
Automation commands

CommandDescription
gitpod automations initInitialize automations config
gitpod automations update automations.yamlUpdate automations from file
gitpod automations task listList tasks
gitpod automations task start <ref>Start a task
gitpod automations task logs <ref>View task logs
gitpod automations service listList services
gitpod automations service start <ref>Start a service

​
Webhook commands

CommandDescription
gitpod webhook createCreate a webhook (--name, --type, --scope, --provider)
gitpod webhook secret get <id>Get the signing secret for a webhook
See Webhooks for setup and SCM registration.

​
Dotfiles commands

CommandDescription
gitpod user dotfiles getView current dotfiles config
gitpod user dotfiles set --repository <url>Set dotfiles repository
gitpod user dotfiles setClear dotfiles config
Supports -o json and -o yaml output. See dotfiles documentation.

​
Project and group commands

CommandDescription
gitpod project listList projects
gitpod project create <repo-url>Create a project
gitpod group listList groups
gitpod group create --name "<name>"Create a group

​
Identity commands

CommandDescription
gitpod whoamiShow current user and access level
gitpod loginAuthenticate via browser
gitpod login --token "<token>"Authenticate with PAT

​
Configuration commands

CommandDescription
gitpod config context listList CLI contexts
gitpod config context use <name>Switch context

​
Shell completion

# Bash
gitpod completion bash > /etc/bash_completion.d/gitpod

# Zsh
gitpod completion zsh > "${fpath[1]}/_gitpod"

# Fish
gitpod completion fish > ~/.config/fish/completions/gitpod.fish

​
Version and updates

CommandDescription
gitpod versionShow CLI version
gitpod version updateUpdate to latest version
gitpod version update --verify-slsaUpdate with SLSA verification
gitpod config set --verify-slsa=trueEnable SLSA verification for all future updates
gitpod config set --autoupdate=trueEnable automatic updates
SLSA verification cryptographically proves the CLI binary was built by the official build system. When enabled, every update checks the Sigstore certificate, Rekor transparency log, and provenance metadata. If verification fails, the update aborts. Configuration is stored at ~/.gitpod/configuration.yaml.