Skip to main content

​
Overview

Manage versions for your deployments. List all versions to see their status, or delete versions you no longer need.

​
Commands

​
List Versions

crewship version list [deployment-id]
If no deployment ID is provided, it is resolved from crewship.toml. Output: 
  Versions (3)

   v3 (production)
   ID:      ver_abc123def456
   Status:  running
   Created: 1/22/2025, 3:00:00 PM

   v2 (production)
   ID:      ver_xyz789ghi012
   Status:  stopped
   Created: 1/20/2025, 1:30:00 PM

   v1 (production)
   ID:      ver_mno345pqr678
   Status:  stopped
   Created: 1/15/2025, 10:45:00 AM

​
Options for list

OptionDescription
--name, -nDeployment name (for multi-deployment configs)
--environmentFilter by environment: production or staging

​
Delete a Version

crewship version delete <version-id>
This soft-deletes the version. If the version was running, it will no longer receive new runs. Existing in-flight runs will complete normally.
Deletion cannot be undone.

​
Options for delete

OptionDescription
--forceSkip confirmation prompt

​
Examples

​
List versions for a deployment

# By deployment ID
crewship version list dep_abc123def456

# From crewship.toml
crewship version list

# For a named deployment
crewship version list --name research-agent

# Filter by environment
crewship version list --environment production

​
Delete a version

crewship version delete ver_abc123def456

# Skip confirmation
crewship version delete ver_abc123def456 --force

Deployments

Manage deployments

Deploy

Deploy your crew