CLI Reference¶

# Launch a new workspace
prism workspace launch <template> <name>
prism workspace launch python-ml my-project
prism workspace launch python-ml my-project --size L
prism workspace launch python-ml my-project --spot
prism workspace launch python-ml my-project --region us-east-1
prism workspace launch python-ml my-project --project brain-study
prism workspace launch python-ml my-project --instance-type m7i.2xlarge

# List workspaces
prism workspace list                         # Running and stopped workspaces
prism workspace cost                         # Show cost breakdown and savings

# Connect to a workspace
prism workspace connect <name>               # Print SSH command + web service URLs

# Run a command remotely
prism workspace exec <name> -- <command>
prism workspace exec my-project -- python train.py

# File operations (via S3 relay)
prism workspace files list <name>            # List files on the instance
prism workspace files push <name> ./data.csv /home/ubuntu/data.csv
prism workspace files pull <name> /home/ubuntu/results.csv ./results.csv

# Open a web service (Jupyter, RStudio, etc.)
prism workspace web <name>                   # List available web URLs
prism workspace web <name> --open jupyter    # Open Jupyter in browser

# Stop / start / delete
prism workspace stop <name>                  # Stop (preserves storage, no compute cost)
prism workspace start <name>                 # Restart a stopped workspace
prism workspace delete <name>                # Permanently terminate

# Hibernation (preserves RAM state, reduces cost)
prism workspace hibernate <name>             # Hibernate
prism workspace resume <name>                # Resume from hibernation

# Instance status
prism workspace status <name>                # Detailed status including cloud-init progress

prism templates                              # List all available templates
prism templates info <name>                  # Detailed info: packages, ports, inheritance
prism templates info python-ml

prism profile add                            # Interactive: add a new profile
prism profile list                           # Show all profiles (active profile marked)
prism profile switch <name>                  # Make a profile active
prism profile delete <name>                  # Remove a profile

# EFS volumes (shared network storage)
prism volume create <name>                   # Create an EFS volume
prism volume list                            # List all volumes
prism volume attach <volume> <workspace>     # Attach to a running workspace
prism volume detach <volume> <workspace>     # Detach
prism volume delete <name>                   # Delete permanently

# EBS volumes are created at launch time with --storage-size
prism workspace launch python-ml my-project --storage-size 100

prism budget list                            # Show all budgets and status
prism budget create <project> <amount>       # Create a $N budget for a project
prism budget status <project>                # Detailed spend and alerts

# Via project subcommand
prism project budget set <project> <amount>  # Set/update budget
prism project budget status <project>        # Budget status
prism project budget history <project>       # Spend history
prism project budget prevent-launches <project>   # Block new launches at budget limit
prism project budget allow-launches <project>     # Re-enable launches

prism keys list                              # List SSH keys registered with Prism
prism keys generate                          # Generate a new key pair
prism keys add <path>                        # Register an existing public key

prism project create <name>                  # Create a project
prism project create <name> --budget 1000    # Create with a $1000 budget
prism project list                           # List all projects
prism project info <name>                    # Project details, members, spend
prism project instances <name>               # Workspaces in this project
prism project members <name>                 # List members
prism project members <name> add <email> <role>     # Add member (owner/admin/viewer)
prism project members <name> remove <email>  # Remove member
prism project delete <name>                  # Delete (must have no running workspaces)

prism invitation send <project> <email>      # Invite a collaborator
prism invitation list <project>              # List invitations for a project
prism invitation mine                        # Invitations sent to you
prism invitation accept <id>                 # Accept an invitation
prism invitation decline <id>                # Decline
prism invitation revoke <id>                 # Cancel a pending invite (owner only)

prism admin daemon status                    # Health check and version
prism admin daemon start                     # Start explicitly (usually not needed)
prism admin daemon stop                      # Stop the daemon

prism admin policy list                      # List access control policies
prism admin quota show                       # Check AWS service quotas
prism admin aws-health                       # AWS service health status
prism admin rightsizing analyze              # Instance sizing recommendations

prism gui                                    # Launch the desktop GUI
prism init                                   # First-run wizard (AWS setup, profile creation)
prism version                                # Show current version
prism templates                              # Alias: same as prism templates list

prism --help
prism workspace --help
prism workspace launch --help