Skip to main content
Every agent has a workspace directory that persists forever.

The Basics

Files written to /workspace survive:
  • Container restarts
  • Worker replacements
  • Daemon restarts
  • Redeployments

Example: Persistent Counter

Test it:

Common Patterns

Cache API Responses

Store Conversation History

SQLite Database

Directory Structure

Manage Workspace

View workspace info:
Clean workspace:

Where Workspaces Live

Workspace Survives Redeploy

When you run orpheus deploy:
  • Code is replaced
  • Workspace is preserved
This means you can update agent logic without losing data.
orpheus undeploy deletes the workspace permanently. Back up important files first.

Next: Long-Running Tasks

Handle tasks that run for minutes →