Settings

Settings are organized into 5 tabs — accessible via the gear icon in the sidebar.

Look & Feel

  • Theme — Light or Dark mode
  • Accent color — customize the primary accent across the UI
  • Environment — choose the 3D world environment (Grass, Island, Sky, Desert)
  • Bot personality — set default bot type for new sessions

Rooms

  • Create, rename, and delete rooms
  • Set auto-assignment rules (match session names by pattern)
  • Link rooms to projects
  • Configure meeting tables per room

Behavior

  • Session timeout — how long until a session is marked stale (default: 30 min)
  • Parking threshold — when to move sessions to the parking area
  • Auto-start meetings — trigger meetings on specific events
  • Notification sounds — on/off for meeting start/end, task completion

Data

  • Backup — export all settings, rooms, and blueprints as JSON
  • Restore — import a settings backup
  • Reset — wipe all data and start fresh
  • Database path — shows current SQLite location

Advanced

  • Debug panel — enable F2/F3/F4 keybindings for 3D debugging
  • API port — change the backend port (requires restart)
  • Log level — verbose logging for troubleshooting
💡

Settings are stored in ~/.crewhub/crewhub.db and persist across restarts. Use Backup before major upgrades.