Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.crewship.dev/llms.txt

Use this file to discover all available pages before exploring further.

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