Settings reference

Use this page as the key reference for Conductor settings files. For the layered settings model, file locations, and precedence rules, start with User and project settings.

Repository settings

Repository settings apply to <repo>/.conductor/settings.toml and <repo>/.conductor/settings.local.toml. They support workspace and repository behavior, not every user preference.

Scripts

TOML key	Type	Description
`scripts.setup`	string	Command to run when Conductor creates a workspace.
`scripts.archive`	string	Command to run before Conductor archives a workspace.
`scripts.run_mode`	string	`concurrent` or `nonconcurrent`.

Run scripts

TOML key	Type	Description
`scripts.run.<id>.command`	string	Command to run from the Run button.
`scripts.run.<id>.args`	string array	Optional arguments passed with the command.
`scripts.run.<id>.options.cwd`	string	Optional working directory relative to the workspace.
`scripts.run.<id>.default`	boolean	Selects this script by default when the project has many run scripts.
`scripts.run.<id>.icon`	string	Lucide icon name shown with the script.
`scripts.run.<id>.hide`	boolean	Hides the script from the Run button. Overridable per layer, so a local layer can hide a shared script.
`scripts.run.<id>.available_in`	string or string array	`local`, `cloud`, or both.
`scripts.run`	string	Legacy single run script. Use `scripts.run.<id>` for multiple scripts.

Workspace behavior

TOML key	Type	Description
`enterprise_data_privacy`	boolean	Enables Enterprise data privacy for the repository.
`spotlight_testing`	boolean	Uses Spotlight testing for projects that must run from the repository root.
`file_include_globs`	string	Files to copy patterns used when `.worktreeinclude` is not present.

Environment variables

TOML key	Type	Description
`environment_variables`	table	Environment variables passed to local and cloud agents in this repository.
`environment_variables.local`	table	Environment variables passed to local agents only.
`environment_variables.cloud`	table	Environment variables passed to cloud agents only.

Prompts

TOML key	Type	Description
`prompts.general`	string	Added to agent sessions for this repository.
`prompts.code_review`	string	Custom prompt for the code review action.
`prompts.create_pr`	string	Custom prompt for the create PR action.
`prompts.fix_errors`	string	Custom prompt for the fix errors action.
`prompts.resolve_merge_conflicts`	string	Custom prompt for the resolve merge conflicts action.
`prompts.rename_branch`	string	Custom prompt for branch naming.

Harnesses

TOML key	Type	Description
`claude_code_executable_path`	string	Override the Claude Code executable path.
`codex_executable_path`	string	Override the Codex executable path.
`claude_provider`	string	Provider backing Claude, such as Anthropic, Bedrock, or Vertex.
`codex_provider`	string	Provider backing Codex.
`bedrock_region`	string	AWS Bedrock region for Claude.
`vertex_project_id`	string	Google Vertex project ID for Claude.
`ssh_key_path`	string	Path to the SSH private key used for cloud workspaces.

Git

TOML key	Type	Description
`git.delete_branch_on_archive`	boolean	Delete the workspace branch when archiving.
`git.archive_on_merge`	boolean	Archive a workspace automatically when its pull request merges.
`git.worktree_push_auto_setup_remote`	boolean	Automatically configure the upstream remote on first push.
`git.branch_prefix_type`	string	How branch name prefixes are generated.
`git.branch_prefix`	string	Custom branch name prefix.

User-only settings

User settings in ~/.conductor/settings.toml support every file-backed setting. These settings are user-only and are ignored in repository settings files.

TOML key	Type	Description
`models.default`	string	Default model for new chats.
`models.review`	string	Model used for code reviews.
`models.default_fast_mode`	boolean	Enable fast mode by default for new chats.
`models.default_plan_mode`	boolean	Start new chats in plan mode by default.
`models.codex.default_thinking_level`	string	Default Codex thinking level for new chats.
`models.codex.review_thinking_level`	string	Codex thinking level used for code reviews.
`models.codex.personality`	string	Default Codex personality.
`models.claude_code.default_effort_level`	string	Default Claude effort level for new chats.
`models.claude_code.review_effort_level`	string	Claude effort level used for code reviews.
`tool_approvals_enabled`	boolean	Require approval before agents run tools.

Managed settings

Managed settings are for organizations. They live in ~/.conductor/settings.managed.toml and override user and repository settings.

TOML key	Type	Description
`enterprise_data_privacy`	boolean	Enables Enterprise data privacy.
`claude_code_executable_path`	string	Overrides the Claude Code executable path.
`models.default`	string	Sets the default model.
`environmentVariables.local`	table	Sets managed environment variables for local agents.
`environmentVariables.cloud`	table	Sets managed environment variables for cloud agents.

For managed file behavior and examples, see Managed settings.

Unsupported by scope

Case	Behavior
User-only settings in a repository file	Conductor ignores them. Put model defaults, tool approvals, and default workspace location in `~/.conductor/settings.toml`.
Unknown keys in a repository settings file	Conductor rejects keys that are not in the repository schema.
Unknown keys in a managed settings file	Conductor ignores unsupported managed keys and applies recognized valid keys.

Schema URLs

File	Schema
`~/.conductor/settings.toml`	`https://conductor.build/schemas/settings.schema.json`
`<repo>/.conductor/settings.toml`	`https://conductor.build/schemas/settings.repo.schema.json`
`<repo>/.conductor/settings.local.toml`	`https://conductor.build/schemas/settings.repo.schema.json`
`~/.conductor/settings.managed.toml`	`https://conductor.build/schemas/settings.toml.json`

On this page