Rovo Dev Action

A GitHub Action to run Rovo Dev (Atlassian's developer AI agent) in your CI/CD workflows.

Features

• 🤖 Run Rovo Dev CLI with custom prompts in GitHub Actions
• 🔐 Secure authentication using Atlassian API tokens
• 🔧 Cross-platform support (Linux, macOS, Windows)
• ⚙️ Custom configuration support

Prerequisites

1. An Atlassian account with access to Rovo Dev
2. A Rovo Dev scoped API token (see documentation)

Usage

Example GitHub Actions Workflow:

name: Update Documentation

on:
  push:
    branches:
      - main
    paths:
      - "README.md"

jobs:
  update-docs:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Run Rovo Dev
        uses: atlassian-labs/rovo-dev-action@v1
        with:
          prompt: "Read README.md and update the Confluence page at https://hello.atlassian.net/wiki/spaces/ROVODEV/pages/000000 to stay consistent"
          atlassian_email: ${{ secrets.ATLASSIAN_EMAIL }}
          atlassian_token: ${{ secrets.ATLASSIAN_TOKEN }}
          config_file: .rovodev/ci-config.yml

Example .rovodev/ci-config.yml:

version: 1

toolPermissions:
  tools:
    get_confluence_page: allow
    create_confluence_page: allow
    update_confluence_page: allow

Inputs

Input	Description	Required	Default
prompt	The prompt/instructions to send to Rovo Dev CLI	Yes	-
atlassian_email	Atlassian account email for authentication	Yes	-
atlassian_token	Rovo Dev scoped API token for authentication	Yes	-
working_directory	Working directory for Rovo Dev CLI execution	No	.
config_file	Path to a custom Rovo Dev configuration file (YAML)	No	""

Outputs

Output	Description
exit_code	Exit code from Rovo Dev CLI execution

Authentication

Setting up Secrets

Add the following secrets to your GitHub repository:

• ATLASSIAN_EMAIL: Your Atlassian account email
• ATLASSIAN_TOKEN: Your Rovo Dev scoped API token

Security

• Never commit API tokens directly in your workflow files
• Always use GitHub Secrets for sensitive credentials

Contributions

Contributions to Rovo Dev Action are welcome! Please see CONTRIBUTING.md for details.

License

Copyright (c) 2025 Atlassian US., Inc. Apache 2.0 licensed, see LICENSE file.