Settings
Settings (/vibecontrols/settings) is the last item in the VibeControls sidebar group. It holds the workspace-wide VibeControls preferences. Account, workspace membership and billing settings live in the shared platform modules; see Other settings.
Every member can change their Notifications section. The other three sections are shown only to roles that can update configuration (Control Plane Owner and Platform Engineer). Reset to defaults restores the section you are looking at.
Notifications
| Setting | Meaning |
|---|---|
| Agent Offline Alerts | Notify when an agent goes offline or its heartbeat is stale. |
| Session Error Alerts | Notify when a session encounters an error. |
| Vibe Status Changes | Notify when a vibe changes status. |
| Email Digest | Receive summary emails of activity. |
| Digest Frequency | Daily, Weekly or None. |
Alerts are delivered through the platform notification service, to the notification centre and by email. Devices where you turned on push notifications also receive them as push (see Platforms).
Workspace
Defaults applied when you create a new session or vibe.
| Setting | Meaning |
|---|---|
| Default Agent | The agent preselected when starting a session. |
| Default Session Type | Tmux, WezTerm, Zellij, SSH, Terminal or Script. |
| Auto-start Sessions | Start sessions automatically when a vibe is activated. |
| Default Vibe Type | Project, Repository, Workspace, Monorepo, Package or Custom. |
| Auto Git Sync | Sync Git status automatically when a vibe is activated. |
Agent tuning
| Setting | Meaning |
|---|---|
| Heartbeat Interval (seconds) | How often agents send heartbeats, from 10 to 300 seconds. A longer interval means an offline agent is noticed later. |
| Max Sessions Per Agent | Upper bound on concurrent sessions on one agent. Your plan's session quota also applies. |
| Auto-reconnect | Agents reconnect on their own after a network drop. |
| Default Environment Variables | Environment variables applied to all new vibes, one KEY=value per line. Do not put secrets here; use Configured Secrets below. |
Code Editor
Default IDE is the editor that Open in editor uses on every vibe. Without a choice it uses VS Code. Per-Vibe overrides pick a different editor for individual vibes; Remove override returns a vibe to the default.
Advanced
| Setting | Meaning |
|---|---|
| Log Level | Debug, Info, Warning or Error for agent logging. |
| Telemetry | Send anonymous usage data to help improve VibeControls. |
| Auto Update | Update agents automatically when new versions are available. |
| Configured Secrets | Workspace secrets available to sessions and actions. Values are write-only: they are stored encrypted and never returned, so the list shows a mask. You can add, refresh and delete secrets. |
Related settings
When webhooks are enabled and your role can list them, the Settings screen also links to Webhooks, which wire external events to actions and sessions. See Webhooks.
Other settings
| What | Where |
|---|---|
| Your password, MFA and active sessions | Auth › Security Settings, Active Sessions, Multi-Factor Auth. See Account and Sign-in. |
| Deactivating or deleting your account | Auth › Security Settings › Danger Zone. See Account and Data Deletion. |
| Who can do what | Permissions. See Roles and Permissions. |
| Members, workspaces and projects | Administration |
| Plan, invoices and usage | Billing. See Plans and Quotas. |
| Language and theme | The header controls. See Navigating the App. |