Skip to content

Settings UI

The Settings page (/settings) organizes all configuration in a sidebar-nav interface (the Settings Sanctum). Changes apply immediately without restarting the daemon. The active section is synced to the URL via ?section= query parameter.

The settings sidebar has these sections:

SectionWhat you configure
ProfileDisplay name, email, avatar, timezone, theme
AgentDefault agent settings and behavior
ProvidersAPI keys and default models for each LLM provider
ProactiveProactive behavior settings, idle triggers
SecurityApproval policies, access controls, permissions
StrategyExecution strategy, team orchestration settings
InterfaceUI appearance, font size, animations, accessibility
MemoryMemory layer toggles, embedding settings
VoiceTTS provider and voice selection
ChannelsPlatform credentials, bindings, adapter settings
BrowserBrowser profile, headless mode, proxy, tab limits
MarketplaceMarketplace account, publishing settings
ChatChat-specific settings and defaults
LicenseLicense key management and plan details

The profile section lets you set:

  • Display name — shown in the UI header and agent history
  • Email — used for notification delivery
  • Avatar — upload a custom profile photo
  • Timezone — affects scheduler time display and quiet hour calculation
  • Theme — Aurora Dark (default), or light mode

For each supported provider, enter your API key and select the default model:

ProviderModels
AnthropicClaude Opus 4.6, Claude Sonnet 4.6, Claude Sonnet 4.5, Claude Haiku 4.5
OpenAIGPT-5.3 Codex, GPT-5.2, GPT-4o, o3 (Reasoning), o4-mini (Fast Reasoning)
OpenRouterClaude Opus 4.6, GPT-5.3 Codex, Gemini 2.5 Pro, Llama 4 Scout, DeepSeek V3.2, Grok 4
GeminiGemini 2.5 Pro, Gemini 2.5 Flash, Gemini 3.1 Pro (Preview), Gemini 3 Flash (Preview)
DeepSeekDeepSeek V3.2, DeepSeek R1 (Reasoner)
xAI GrokGrok 4.20 (Reasoning), Grok 4, Grok 4 Fast, Grok 3
GroqGPT-OSS 120B, GPT-OSS 20B (Fast), Llama 4 Scout, Llama 3.3 70B
MistralMistral Large 3, Mistral Small 4, Devstral 2 (Coding), Codestral

API keys are stored in ~/.snippbot/config.toml and masked in the UI. Custom providers can be added via the Custom Provider Modal.

Configure approval policies, access controls, and permissions for agents and users.

Configure execution strategy for projects and team orchestration settings (Architect, Executor, Reviewer loop).

Customize the UI appearance:

  • Theme selection
  • Font size
  • Animation toggle
  • Accessibility settings

Configure memory layers:

  • Episodic memory enable/disable
  • Vector embedding settings
  • Knowledge graph configuration

Configure TTS (text-to-speech) settings:

  • Provider selection
  • Voice selection per agent

Configure how Snippbot connects to and manages browser instances for automation tasks:

  • Profile: Choose between Managed Chromium (built-in), System Chrome (your installed Chrome), CDP (connect to an existing Chrome DevTools Protocol endpoint), or Browserless (remote browser service)
  • Headless: Toggle headless mode on or off (default: on)
  • CDP URL: When using the CDP profile, enter the DevTools Protocol URL to connect to
  • Browserless Token: When using the Browserless profile, enter your API token
  • Chrome Executable: When using System Chrome, specify the path to your Chrome binary
  • Max Tabs: Maximum number of browser tabs the agent can open simultaneously (default: 10)
  • Default Timeout: Page load and action timeout in seconds (default: 30)
  • Proxy Settings: Optional proxy server URL, username, and password for routing browser traffic

The Channels section configures platform integrations:

Click any platform to configure it. Each shows:

  • Connection status (connected / not configured / error)
  • Credential form (platform-specific fields)
  • Bindings list

Create and manage channel-to-agent bindings:

  • Select a platform channel
  • Select which agent handles messages
  • Set access mode (open / allowlist / admin_only)
  • Manage the user allowlist
  • Adapter port: port the channel adapter listens on (default: 18790)
  • Public URL: your externally accessible URL (required for webhooks)
  • Rate limits: messages per minute and per hour
  • Proactivity: enable/disable and set quiet hours

Configure marketplace account settings, publishing preferences, and manage your publisher dashboard.

Chat-specific settings including default conversation behavior, with a setup walkthrough for first-time configuration.

Manage your license key and view current plan details.