Use subagents in Rovo Dev CLI

Rovo Dev has an interactive menu with all created subagents

Rovo Dev can delegate specific tasks to subagents with specialized capabilities, custom system prompts, and tailored tool configurations.

Subagents only use context supplied by Rovo Dev, ensuring focused execution and reducing the overall context size of the main agent.

Subagents are available to Rovo Dev through the invoke_subagent tool. To use subagents reliably, it’s best to explicitly tell Rovo Dev to invoke them. But Rovo Dev can still attempt to delegate relevant tasks to subagents without being asked.

Create a subagent

A subagent’s capabilities are defined by its system prompt and the tools it has access to.

To get the best output from your subagent, in its system prompt you should define its role and expertise, specific tasks it should perform, guidelines for how it should approach problems, and expected output format or style.

To create a subagent:

  1. Run /subagents to open the subagent.

  2. Select Create a subagent.

  3. Choose the scope, user-level or project-level.

  4. Enter a name and description, select an AI model.

  5. Enter a system prompt as instructions for the subagent, and specify tools the subagent can use.

Manual configuration

Subagents are stored as markdown files with YAML frontmatter. There are two directories for the two types of subagents:

  • ~/.rovodev/subagents/ - User-level subagents, available across all projects.

  • .rovodev/subagents/ - Project-level subagents, available only in the current project.

Create a markdown file in this format:

--- name: [name] description: [one-line-description] tools: - [tool1] - [tool2] - [tool3] --- [System prompt]

For example:

.rovodev/subagents/code-reviewer.md

--- name: code-reviewer description: Reviews code and suggests improvements tools: - open_files - expand_code_chunks - grep - bash --- You are an expert code reviewer focused on identifying potential issues and suggesting improvements. When reviewing code, you should: 1. Check for potential bugs and logical errors 2. Identify security vulnerabilities 3. Suggest performance improvements 4. Verify adherence to coding standards 5. Recommend better patterns or practices Provide specific, actionable feedback with examples when possible.

Manage subagents in interactive mode

Use /subagents to open the interactive interface where you can view and edit existing subagents.

Invoke subagents

To get Rovo Dev to invoke a subagent, just ask in your prompt.

For example:

Use the code-reviewer subagent to conduct a code review of the latest commit

Still need help?

The Atlassian Community is here for you.