Settings Reference
Open Settings with ⌘+, or from the gear icon. Use this directory to reach the detailed guide for each settings page. Those guides document the controls and their behavior.
Use Search Settings to find an option by name. For supported integrations, account requirements, model availability, and capabilities, use Providers & Models.
Agent Mode
- Overview: general Agent Mode behavior and supervision.
- CLI Providers: connect and configure coding runtimes.
- Agent Models: model choices for agent roles and supporting tasks.
- Agent Permissions: direct-agent and sub-agent permissions.
- Agent Workflows: workflow behavior and related controls.
- Agent Decisions: automatic routing, effort selection, usage balancing, and decision services.
- Context Builder: discovery and context-generation settings.
General Settings
- Appearance: interface appearance and text presentation.
- Updates: update checks and release channels.
- Notifications: notification preferences.
- Keyboard Shortcuts: configurable shortcuts.
- Advanced: advanced preferences, including the URL Opener.
- Telemetry: crash-report and diagnostic controls.
API Settings
The settings category is Models & Providers. Start with Providers & Models for the canonical connection and capability reference, then open the relevant settings guide:
Chat Settings
The settings category is Prompting:
- Chat Settings: built-in chat behavior.
- Copy Prompt Order: ordering and packaging copied context.
- Workflow Presets: preset instructions and workflow definitions.
MCP Settings
- MCP Server: server configuration and connections.
- Workspace Approvals: workspace access approvals.
- Tools: tool availability and configuration.
- Model Presets: model choices exposed through MCP.
Workspace Settings
- Manage Workspaces: workspace and folder management.
- Manage Presets: saved workspace selections and presets.
Scripting settings
A subset of preferences is available through MCP and rpce-cli. Use the App Settings Tool for the authoritative allowlist and the Setup Guide for terminal access. A control being visible in Settings does not mean it is available through that tool.