Is there a reference for Rovo's configuration files?

[Rob Stevenson]

Is there a reference for the values that are possible in Rovo's configuration files, such as ~/.rovodev/config.yml, and what the configuration options do?

[Jovana Dunisijevic]

Hey @Rob Stevenson 

Yes, there is reference information available for the configuration options in Rovo Dev’s configuration files, such as ~/.rovodev/config.yml.

Configuration File Reference

The main configuration file for Rovo Dev CLI is located at ~/.rovodev/config.yml. This file controls global settings, preferences, and permissions for how Rovo Dev operates on your machine.

Common Configuration Options

• Global User Memory
  Stores your personal preferences and instructions for the AI agent (e.g., code style, tooling shortcuts).

  • File: ~/.agent.md (for global/personal memory)

• Repo User Memory
  Stores repo-specific preferences and instructions for the AI agent, only applied within a specific repository.

  • File: .agent.local.md (in the repo root, not checked into Git)

• Permissions
  You can manage which local tools Rovo Dev is allowed to use (e.g., GitHub CLI, linters, test runners) by editing the permissions section in ~/.rovodev/config.yml.

• Model Context Protocol (MCP) Servers
  Configure external data sources for Rovo Dev to use as context by editing ~/.rovodev/mcp.json.

Instructions and Saved Tasks

• You can save reusable prompts and instructions in .rovodev/instructions.yml and access them in interactive mode with /instructions.

Team and Personal Memory Files

• Personal (global): ~/.agent.md

• Personal (repo): .agent.local.md (in repo root)

• Team (repo): .agent.md (in repo root or subdirectories)

How to View/Edit Your Config

• Open your config file with:
  acli rovodev config
  (opens ~/.rovodev/config.yml in your default editor)

If you need a full list of all possible configuration keys and their descriptions, use the built-in help command:

acli rovodev --help

https://support.atlassian.com/rovo/docs/use-advanced-rovo-dev-cli-features/

Hopefully this helps!

Kindest regards,

Jov

[Rob Stevenson]

Thanks Jov, but is there a more detailed reference?

For example my `~/.rovodev/config.yml` has defaulted `console.editingMode` to `EMACS`, but what other values are possible?

I'd like a detailed reference covering all of the options that are possible in `config.yml` and what values can be set for each, plus what each value would do.

Neither `acli rovodev --help` nor `acli rovodev config --help` provide this info

[Jovana Dunisijevic]

Hey @Rob Stevenson !

Unfortunately, at this time, we don’t have a single, comprehensive public reference yet that lists every possible option and value for ~/.rovodev/config.yml, along with detailed descriptions of what each does.

I understand this would be very valuable for you, and this feedback is actually helping us prioritize this for our documentation roadmap.

Regarding your specific example:

• The console.editingMode option controls the keybindings and editing behavior in the Rovo Dev CLI console.

• Possible values typically include:

  • EMACS (default): Emacs-style keybindings (e.g., Ctrl+A for start of line, Ctrl+E for end of line)

  • VIM: Vim-style modal editing (if supported)

  • DEFAULT or STANDARD: Standard/basic keybindings (if available)

• The exact set of supported values may depend on your CLI version. If you try setting an unsupported value, the CLI will usually fall back to the default.

Current documentation:

• The built-in help commands (acli rovodev --help and acli rovodev config --help) currently do not provide a full schema or exhaustive list of config options and values.

• The Use advanced Rovo Dev CLI features | Rovo | Atlassian Support page covers some advanced settings, but not all possible config keys.

Next steps:

• If you have questions about specific config options, please let me know which ones and I’ll do my best to provide details on possible values and their effects.

• I'll be passing this request for a detailed config reference to our documentation team.

Please let me know if there are other settings you’d like more information about, or if you have any other questions!

Kindest regards,

Jov