Skip to main content
workers

​
Deployment

​
deploy

Deploy an agent from a directory. 
orpheus deploy <path>
Example: 
orpheus deploy ./my-agent

​
undeploy

Remove a deployed agent. 
orpheus undeploy <name>
Warning: This deletes the workspace.

​
list

List all deployed agents. 
orpheus list

​
Execution

​
run

Execute an agent with JSON input. 
orpheus run <name> '<json>'
Options:
  • --session <id> - Session ID for affinity
Example: 
orpheus run my-agent '{"query": "hello"}' --session user-123

​
Monitoring

​
status

Check daemon health. 
orpheus status

​
stats

View agent statistics. 
orpheus stats <name>
Shows workers, queue depth, health status.

​
runs

View execution history. 
orpheus runs <name>
Options:
  • -n <count> - Number of results
  • --state <state> - Filter by state (completed, failed, crashed)
  • --source <http|mcp> - Filter by request source
Example: 
orpheus runs my-agent -n 10 --state failed
orpheus runs my-agent --source mcp

​
Workspace

​
workspace info

View workspace details. 
orpheus workspace info <name>

​
workspace clean

Delete workspace contents. 
orpheus workspace clean <name> --force

​
VM (macOS only)

​
vm start

Start the Lima VM. 
orpheus vm start

​
vm stop

Stop the Lima VM. 
orpheus vm stop

​
Environment Variables

VariableDescription
ORPHEUS_URLDaemon URL (default: http://localhost:7777)
ORPHEUS_SOCKETUnix socket path
Example: 
ORPHEUS_URL=http://192.168.1.100:7777 orpheus status