proto.config.example.yaml

# protoLabs Studio Mesh — Multi-Instance Configuration
# Copy to proto.config.yaml and customize for your instance.
# See docs/dev/studio-mesh.md for full documentation.
#
# This file activates Studio Mesh (CRDT sync) — without it, the server
# runs in single-instance mode (plain filesystem reads/writes).

# Project name — instances must share the same name to sync
name: my-project

protolab:
  # role: primary | worker
  # primary: owns leader election, workers defer to primary
  role: primary
  # WebSocket port for mesh sync
  syncPort: 9800
  # Stable unique identifier for this instance
  instanceId: my-instance

# Instance identity — who this instance is and what work it prefers
instance:
  # Human-readable display name
  name: 'Dev Machine'
  # Primary work focus: fullstack | frontend | backend | infra | docs | qa
  # Role influences work routing but doesn't hard-block assignments
  role: fullstack
  # Additional capabilities beyond the primary role
  tags: [backend, infra]

hivemind:
  enabled: true
  # How often to broadcast capacity heartbeats (ms)
  heartbeatIntervalMs: 30000
  # Mark a peer as unreachable after this duration without heartbeat (ms)
  peerTtlMs: 120000
  # All instances in the mesh (including self)
  peers:
    - ws://100.x.x.x:9800
    - ws://100.y.y.y:9800

# Pull-based work intake from shared projects
workIntake:
  # Whether work intake is enabled (default: true when mesh is active)
  enabled: true
  # How often to check for claimable phases (ms)
  tickIntervalMs: 30000
  # Timeout before a stale claim becomes reclaimable (ms, default: 30min)
  claimTimeoutMs: 1800000