Skip to main content

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​

SettingMeaning
Agent Offline AlertsNotify when an agent goes offline or its heartbeat is stale.
Session Error AlertsNotify when a session encounters an error.
Vibe Status ChangesNotify when a vibe changes status.
Email DigestReceive summary emails of activity.
Digest FrequencyDaily, 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.

SettingMeaning
Default AgentThe agent preselected when starting a session.
Default Session TypeTmux, WezTerm, Zellij, SSH, Terminal or Script.
Auto-start SessionsStart sessions automatically when a vibe is activated.
Default Vibe TypeProject, Repository, Workspace, Monorepo, Package or Custom.
Auto Git SyncSync Git status automatically when a vibe is activated.

Agent tuning

SettingMeaning
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 AgentUpper bound on concurrent sessions on one agent. Your plan's session quota also applies.
Auto-reconnectAgents reconnect on their own after a network drop.
Default Environment VariablesEnvironment 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​

SettingMeaning
Log LevelDebug, Info, Warning or Error for agent logging.
TelemetrySend anonymous usage data to help improve VibeControls.
Auto UpdateUpdate agents automatically when new versions are available.
Configured SecretsWorkspace 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.

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​

WhatWhere
Your password, MFA and active sessionsAuth › Security Settings, Active Sessions, Multi-Factor Auth. See Account and Sign-in.
Deactivating or deleting your accountAuth › Security Settings › Danger Zone. See Account and Data Deletion.
Who can do whatPermissions. See Roles and Permissions.
Members, workspaces and projectsAdministration
Plan, invoices and usageBilling. See Plans and Quotas.
Language and themeThe header controls. See Navigating the App.

Next steps​