Skip to main content

​
Usage

zwrm agent <type> [instance]
The shorthand zwrm a also works: 
zwrm a claude

​
Arguments

ArgumentTypeDescription
typestringAgent type (claude, codex) or subcommand (list, destroy)
instancestring (optional)Named instance identifier

​
Flags

FlagTypeDefaultDescription
--templatestring—Use a template from the registry
--sizestring—VM size preset
--shellboolfalseStart plain bash instead of the agent command
--cmdstring—Override the default startup command
--instancestring—Named instance (alternative to positional arg)

​
Examples

​
Basic usage

# Start a Claude agent
zwrm agent claude

# Start a Codex agent
zwrm agent codex

# Connect with plain bash (no agent auto-start)
zwrm agent claude --shell

​
Named instances

# Create separate instances for different projects
zwrm a claude my-project
zwrm a claude experiments

# Use a template
zwrm a claude --template python-ml

​
Custom VM size

zwrm a claude --size performance-4x

​
Managing agents

​
List all agents

zwrm agent list
or: 
zwrm a list
Shows all running and stopped agent instances.

​
Destroy an agent

zwrm agent destroy <instance>
or: 
zwrm a destroy my-project
This stops the VM and removes the instance. The persistent home volume is deleted.