Skip to main content
Workspaces are isolated virtual machines with your repository cloned and a coding agent ready to work. Each workspace runs the Replicas Engine, which manages agent sessions, message queues, and git operations.

Lifecycle

Workspaces move through three states:
StateDescription
BootingVM starting, cloning repo, installing dependencies
ActiveReady for messages, agent working
SleepingPaused, no credits consumed

What Runs Inside

Each workspace runs the Replicas Engine on port 3737, which:
  • Manages Claude Code and Codex agent sessions
  • Queues messages when agents are busy
  • Handles git operations (branch creation, commits)
  • Refreshes authentication tokens automatically
  • Supports Docker for running containerized development services inside the workspace
Messages sent while an agent is processing are queued and executed in order.

Collaboration and Review

  • Create multiple chats per workspace to split workstreams and keep context organized.
  • Use the built-in Diff Viewer to inspect pending code changes without leaving the dashboard.
  • Use the Files view to browse workspace files directly in the dashboard.

Repository Targeting

Workspaces can run against one repository or multiple repositories.
  • Select individual repositories during workspace creation.
  • Use Repository Sets to save common multi-repository combinations and reuse them quickly.

Environment Configuration

Configure workspace environment variables and files in dashboard settings:
  • Global (all workspaces)
  • Per repository
  • Per repository set
Open settings at Environment.

Sleep and Wake

Auto-sleep: Workspaces sleep after 1 hour of inactivity. Auto-delete: Sleeping workspaces are permanently deleted after:
  • 24 hours (Hobby plan)
  • 72 hours (Developer plan)
Wake behavior: When a workspace wakes, it resumes the previous agent session and git branch. You can send messages to sleeping workspaces and they’ll wake automatically to process your message.

Billing

Credits are consumed only while workspaces are active. See Credits for rates.