Settings
Every Proliferate setting.
The desktop app's Settings window is organized into four scopes, shown as tabs across the top: User, Org, Repo, and Agents. Each scope has its own short sidebar of sections. Support and desktop updates sit at the bottom of every sidebar, outside the four scopes.
Screenshot: Settings window with the User/Org/Repo/Agents scope tabs
The Settings window shell showing the four scope tabs across the top and the section sidebar for the active scope.
User
Personal settings, tied to your account.
| Section | What it controls |
|---|---|
| Account | Your profile and signed-in account. |
| General | Default open-in target, git branch prefix, new-workspace mode, paste-to-attachment, sounds, and session policy. See Preferences. |
| Appearance | Theme, window zoom, font sizes, and transparent chrome. See Preferences. |
| Personal secrets | Env vars and files available in your own cloud sandbox. See Secrets. |
| Integrations | Connect third-party tools (Linear, Notion, and others) for agents to call. See Integrations. |
| Pruning | Review worktree storage and prune stale local checkouts. |
Org
Organization-wide settings. Most sections are admin-only.
| Section | What it controls |
|---|---|
| Organization settings | Org profile, GitHub App installation, and the agent policy (allowed harnesses and auth routes). See Allowed harnesses. |
| Members | Invite and manage organization members and roles. |
| Billing | Plan and billing state. |
| Organization secrets | Env vars and files available in every member's cloud sandbox. See Secrets. |
| Integrations | Enable or disable integration providers for the organization, and register custom ones. |
| Model policy (Policies) | Planned. Org-wide model availability and default routing. Not available yet; the live control for restricting agents today is the agent policy under Organization settings. |
| Single sign-on (Authentication) | Configure OIDC SSO for the organization. See Identity. |
Repo
Per-repository defaults, picked one repository at a time. Configure and Actions each split into a Cloud and a Local view, since cloud and local workspaces for the same repo can carry different defaults.
| Section | What it controls |
|---|---|
| Configure | Default branch for new workspaces and pull requests, for this repo. |
| Actions | Setup script and run command for this repo. |
| Environment | Env vars and files synced into this repo's cloud workspaces. Cloud only; local workspaces read your shell and checkout directly. |
See Defaults for what each Repo section does in practice.
Agents
Per-agent authentication, models, and launch defaults.
| Section | What it controls |
|---|---|
| Overview | Every installed agent, its status, and a link into its own page. |
| Claude Code / Codex / OpenCode / Grok | Authentication (native sign-in, API key, or the Proliferate gateway) and the full model catalog, per agent. Each supported agent gets its own page. |
| API keys | Provider API keys stored once and reusable across any agent's authentication. |
| Defaults | Default agent for new chats, plus per-agent default model and launch controls (permissions, reasoning, fast mode). |
See Agent configuration for the full walkthrough.
Existing sessions keep the agent, model, and mode they were started with. Changes to Agents settings only affect new chats.