Global Settings
The Settings area exposes platform-wide configuration that is not tied to a single workspace. These values affect every workspace, every session, and every queue. Permissions: settings.view to read, settings.manage to change (admins always have access).
Where to Find It
Sidebar → Settings → Global. All values are persisted in the database (or in appsettings.json where noted) and take effect immediately, without restarting the API.
Tickets Queue
| Setting | Default | Description |
|---|---|---|
| Low Priority Execution Hour | 2 | Hour of the day (0–23, server local time) when low-priority tickets are eligible to run. Used to defer non-urgent work to off-hours. |
AI ticket concurrency is configured per host: each session host has its own Max Concurrent Tickets value, set on the Hosts page. For each queued ticket the gate looks for a host that can actually run it — workspace-allowlist-compatible, agent provider installed, online, with at least one free slot under its own cap. If no host fits, the ticket waits. To raise overall throughput, enable more hosts or raise individual host caps; to dedicate a host to specific workspaces, set its allowlist.
Insights
| Setting | Default | Description |
|---|---|---|
| Insights Enabled | true | Master switch for auto-extraction of insights from completed Develop sessions. |
| Insights Provider | claude | Agent provider used to extract Insights. Pick a low-cost, fast model — extraction is short and high-volume. |
| Insights Model | provider default | Model used by the Insights provider. |
Merge Conflicts
| Setting | Default | Description |
|---|---|---|
| Merge Conflicts Provider | claude | Agent provider used for AI-assisted merge conflict resolution. |
| Merge Conflicts Model | provider default | Model used by the Merge Conflicts provider. Pick one strong at code reasoning. |
| Manual Merge Conflicts | false | When true, AI resolution is skipped and every conflict goes straight to the three-pane diff editor. |
Code Review
| Setting | Default | Description |
|---|---|---|
| Code Review Enabled | false | Run an automated code review pass on completed sessions. |
| Code Review Provider | none | Agent provider used for code review. Defaults to the workspace's session provider when unset. |
| Code Review Model | none | Model used by the code review provider. |
| Code Review Mode | FixAndReport | FixAndReport (apply safe fixes and report the rest, default), ReportOnly (post findings only), or SystemPrompt (let the per-workspace prompt drive behavior). |
Verification
| Setting | Default | Description |
|---|---|---|
| Verification Enabled | false | Run an automated verification pass after Code Review. |
| Verification Provider | none | Agent provider used for verification. |
| Verification Model | none | Model used by the verification provider. |
| Verification Mode | FixAndReport | FixAndReport (default), ReportOnly, or SystemPrompt. |
Hosts Settings
The following settings live on the Hosts page Settings tab (sidebar → Hosts → Settings), not on the global Settings page. They control host-related behavior: agent approval, worktree pooling, and network allow-lists.
Agent Approval
| Setting | Default | Description |
|---|---|---|
| Require Admin Approval for Agents | true | When enabled, newly registered Deploy and Session Agents must be approved by an admin on the Hosts page before they can pick up work. |
Worktree Pool
| Setting | Default | Description |
|---|---|---|
| Enable Idle Worktree Reuse Pool | false | Keep idle worktrees around so new sessions can grab a pre-cloned tree instead of cloning fresh. |
| Idle Worktree Pool Size | 3 | How many idle worktrees to keep per workspace when the pool is enabled. |
| Idle Worktree Max Age | none | If set, idle worktrees older than this duration are evicted from the pool. |
IP Restrictions
| Setting | Default | Description |
|---|---|---|
| Session Agents | empty | Allowed IPs / wildcard patterns (e.g. 192.168.*.*) that can connect to the session-agent hub. Empty = allow all. |
| Deployment Agents | empty | Same, but for the deployment-agent hub. |
Bash Permissions
The Bash Permissions tab lets administrators block dangerous shell commands across every agent session. Each rule is a pattern plus an optional reason; when a session's shell-tool call matches a rule, the command is rejected before it runs and the agent receives the reason so it can adapt.
| Pattern form | Example | Matches |
|---|---|---|
| Substring | git push | Any command containing git push (case-insensitive). |
Glob (* / ?) | git push* | git push, cd x && git push --force, etc. |
Regex (/.../) | /^rm\s+-rf/ | A command starting with rm -rf. |
Rules defined here are global — they apply to all workspaces. Each workspace can add its own rules on top of these on the workspace's Bash Permissions tab; the effective set for a session is the union of global and workspace rules. Requires the Manage Settings permission.
Read-Only (from appsettings.json)
These show in the Settings UI for visibility but are configured in appsettings.json and require an API restart to change.
| Setting | Source | Description |
|---|---|---|
| Client URL | appsettings.json: ClientUrl (or env ClientUrl) | Base URL of the React client. Used for shared links, public bot URLs, and OAuth redirects. Falls back to the request URL if unset. |
| MCP URL | appsettings.json: McpUrl (or env McpUrl) | Public URL advertised for the MCP endpoint when generating provider configurations. |
| Database Provider | appsettings.json: Database:Provider | Active database provider (read-only here — see Database). |
AI Cost Budgets
The global monthly spend cap, the warning threshold, and the block-on-breach toggle are configured under Settings → General → Global AI Cost Budget. These are documented in full in the AI Cost Budgets guide.
Branding
The custom logo and main accent color are configured under Settings → Branding. See the Branding guide.
Provider Model Configurations
Each configured agent provider also appears in the Settings UI with its path, model visibility toggles, and custom models. See Agent Providers.
See Also
- Agent Providers — provider paths and custom models
- System Logs — runtime logging configuration
- Authentication — OAuth and JWT settings
- Environment Variables — workspace-level secrets and config