Workspace Guide

A workspace is a cloud Linux container with Claude Code pre-configured. Each workspace has its own filesystem, Git, and development tools.

Lifecycle

Workspaces go through these states:

  1. Creating — container is being provisioned (~30s)
  2. Running — active and ready for use
  3. Paused — stopped but files are preserved
  4. Archived — compressed for cold storage
  5. Deleted — permanently removed

Persistence

Your files persist across pause/resume cycles. When you pause a workspace:

  • All files in /home/dev/workspace/ are saved
  • Git history is preserved
  • VS Code settings are preserved
  • The Claude conversation history is saved separately in the database

When a workspace is archived, files are compressed into a tarball for cold storage. Archived workspaces can be restored later.

Modes

Concierge Mode (Default)

The web chat interface. You talk to Claude through a real-time chat UI. Best for:

  • Quick prototyping
  • Learning and experimentation
  • Building projects from scratch

CLI Mode

Use the codrsync CLI to start workspaces from your terminal. Best for:

  • Integrating with local workflows
  • Automating workspace creation
  • Bring Your Own Key (BYOK) mode

Task Mode

Submit a task prompt and get results asynchronously. The workspace runs in the background and notifies you when done.

Session Timer

Free trial workspaces have a 30-minute session limit. The timer is visible in the top bar. When time is almost up:

  • A 5-minute warning appears
  • You can save your work and download files
  • After the timer expires, the workspace is automatically paused

Pro plan users have unlimited session time.

Resource Tiers

TierCPURAMStorage
Basic (Free/Pro)1 vCPU0.75 GB10 GB
Pro (Pro+/Team)2 vCPU2 GB20 GB
Power (Enterprise)4 vCPU4 GB50 GB

Custom Domains

Pro+ and higher plans can attach a custom domain to their workspace. Your workspace becomes accessible at yourdomain.com in addition to the default *.ws.codrsync.dev subdomain.

Tips

  • Save early, save often — use Git commits to preserve your work
  • Use templates — they configure Claude for your specific project type
  • Pause when idle — paused workspaces don't count against session time
  • Download files — use the file manager or git push to export your work