User Settings

The .rover/settings.json file stores user-specific preferences that should not be shared across your team. This file is automatically added to .gitignore when you run rover init.

Configuration Options

Field	Description
`aiAgents`	List of AI agents installed on your machine
`defaults.aiAgent`	Your preferred AI agent to use by default
`defaults.models`	Default model to use for each AI agent
`defaults.watchIntervalSeconds`	Polling interval for `rover list --watch` (1-60 seconds, default: 3)

Basic Structure

Here’s a typical user settings file:

{
  // Schema version for automatic migration
  "version": "1.0",

  // AI agents installed on this machine
  "aiAgents": ["claude", "gemini"],

  // Default preferences
  "defaults": {
    "aiAgent": "claude",
    "models": {
      "claude": "sonnet"
    }
  }
}

Setting a Default Agent

Choose your preferred AI agent:

{
  "version": "1.0",
  "aiAgents": ["claude", "gemini"],
  "defaults": {
    "aiAgent": "gemini"
  }
}

The default agent is used when you create tasks without explicitly specifying an agent. You can always override this choice for specific tasks:

rover task --agent claude "Fix the login bug"

Default Models

Configure which model each AI agent should use by default. This is useful when you want to use a specific model tier (like Claude’s Opus or Sonnet) without specifying it every time.

{
  "version": "1.0",
  "aiAgents": ["claude", "gemini"],
  "defaults": {
    "aiAgent": "claude",
    "models": {
      "claude": "opus",
      "gemini": "flash"
    }
  }
}

The available models depend on each AI agent. Common options include:

Agent	Example Models
`claude`	`opus`, `sonnet`, `haiku`
`gemini`	`pro`, `flash`

You can override the default model for specific tasks using the --agent agent:model syntax:

rover task --agent claude:sonnet "Quick code review"

Reference

For a complete list of all available configuration options, see the User Config Reference.

Next Steps

Project Configuration Configure project-wide settings

Hooks Run custom commands at task lifecycle events

Telemetry Learn what data Rover collects and how to disable it