watchfire settings

Configure project settings interactively.

Usage

watchfire configure
watchfire config       # alias

Description

watchfire configure lets you interactively update your project's settings. It presents each configurable option and saves changes to .watchfire/project.yaml.

Configurable Settings

Setting	Description	Default
Sandbox mode	Sandbox mechanism for agent processes	sandbox-exec
Auto-merge	Automatically merge completed task branches to the default branch	true
Auto-delete branch	Delete worktree branches after successful merge	true
Auto-start tasks	Start an agent automatically when a task status is set to ready	true
Default agent	The coding agent to use for sessions	claude-code
Project color	Hex color used to identify the project in the GUI	—

Notes

• Settings are stored in .watchfire/project.yaml
• Changes take effect immediately for new agent sessions
• Running agent sessions are not affected by settings changes
• Initial settings are configured during watchfire init

Examples

# Configure project settings
watchfire configure

# Using the alias
watchfire config