### Execute Basic Rovo Dev Task

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

A workflow example that triggers Rovo Dev on push events to perform analysis without creating a pull request.

```yaml
name: Run Rovo Dev Task

on:
  push:
    branches: [main]

jobs:
  rovo-task:
    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: "Analyze the codebase and suggest improvements in a markdown report"
          atlassian_email: ${{ secrets.ATLASSIAN_EMAIL }}
          atlassian_token: ${{ secrets.ATLASSIAN_TOKEN }}
```

--------------------------------

### Set Repository Secrets with GitHub CLI

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

Use the `gh secret set` command to configure secrets for your GitHub repository. Ensure you have the GitHub CLI installed and authenticated.

```bash
gh secret set ATLASSIAN_EMAIL --body "your-email@company.com"
```

```bash
gh secret set ATLASSIAN_TOKEN --body "your-rovo-dev-api-token"
```

--------------------------------

### Access Rovo Dev Action Outputs

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

Demonstrates how to retrieve execution status and PR details from the action using step outputs.

```yaml
jobs:
  automate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Run Rovo Dev
        id: rovo
        uses: atlassian-labs/rovo-dev-action@v1
        with:
          prompt: "Update the changelog with recent changes"
          atlassian_email: ${{ secrets.ATLASSIAN_EMAIL }}
          atlassian_token: ${{ secrets.ATLASSIAN_TOKEN }}
          create_pr: "true"
          github_token: ${{ secrets.GITHUB_TOKEN }}

      - name: Check Results
        run: |
          echo "Exit code: ${{ steps.rovo.outputs.exit_code }}"
          echo "PR created: ${{ steps.rovo.outputs.pr_created }}"
          echo "PR URL: ${{ steps.rovo.outputs.pr_url }}"
          echo "Branch: ${{ steps.rovo.outputs.branch_name }}"
```

--------------------------------

### Configure Rovo Dev GitHub Actions Workflow

Source: https://github.com/atlassian-labs/rovo-dev-action/blob/main/README.md

Integrate the Rovo Dev action into a CI/CD pipeline to execute tasks like documentation updates. Requires valid Atlassian credentials stored as GitHub secrets.

```yaml
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
```

--------------------------------

### Configure Rovo Dev Action Inputs

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

Defines the required and optional inputs for the Rovo Dev Action, including authentication and PR creation settings.

```yaml
- name: Run Rovo Dev
  uses: atlassian-labs/rovo-dev-action@v1
  with:
    # Required inputs
    prompt: "Your instructions for Rovo Dev"
    atlassian_email: ${{ secrets.ATLASSIAN_EMAIL }}
    atlassian_token: ${{ secrets.ATLASSIAN_TOKEN }}

    # Optional inputs
    working_directory: "."                    # Directory for CLI execution
    config_file: ".rovodev/ci-config.yml"     # Custom configuration file path

    # PR creation options
    create_pr: "true"                         # Enable automatic PR creation
    github_token: ${{ secrets.GITHUB_TOKEN }} # Required when create_pr is true
    pr_title: "feat: automated changes"       # PR title
    pr_body: "Changes made by Rovo Dev"       # PR description
    pr_base_branch: "main"                    # Target branch for PR
    branch_prefix: "rovodev/"                 # Prefix for auto-created branches
```

--------------------------------

### List Repository Secrets with GitHub CLI

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

Verify that your secrets have been successfully set by using the `gh secret list` command. This command displays all secrets configured for the current repository.

```bash
gh secret list
```

--------------------------------

### Sync Documentation to Confluence

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

Automates the synchronization of repository documentation to a specific Confluence page when changes are pushed.

```yaml
name: Sync Documentation to Confluence

on:
  push:
    branches: [main]
    paths:
      - "README.md"
      - "docs/**"

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

      - name: Sync to Confluence
        uses: atlassian-labs/rovo-dev-action@v1
        with:
          prompt: |
            Read README.md and update the Confluence page at
            https://mycompany.atlassian.net/wiki/spaces/DEV/pages/123456
            to stay consistent with the repository documentation.
          atlassian_email: ${{ secrets.ATLASSIAN_EMAIL }}
          atlassian_token: ${{ secrets.ATLASSIAN_TOKEN }}
          config_file: .rovodev/ci-config.yml
```

--------------------------------

### Define Rovo Dev Configuration File

Source: https://github.com/atlassian-labs/rovo-dev-action/blob/main/README.md

Specify tool permissions for the Rovo Dev CLI in a YAML configuration file.

```yaml
version: 1

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

--------------------------------

### Rovo Dev CI Configuration

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

Configuration file for controlling agent behavior, tool permissions, and Atlassian integrations within a CI environment.

```yaml
# .rovodev/ci-config.yml
version: 1

# Agent behavior settings
agent:
  streaming: true
  temperature: 0.3
  modelId: auto
  enableDeepPlanTool: false

# Session storage for CI
sessions:
  persistenceDir: /home/runner/.rovodev/sessions

# Atlassian integrations
atlassianConnections:
  enabled: true
  jiraProjects:
    - url: https://mycompany.atlassian.net/browse/PROJ
      key: PROJ
      id: '12345'

# Console output settings
console:
  outputFormat: markdown
  showToolResults: true
  maxOutputWidth: 120

# Tool permissions - critical for CI automation
toolPermissions:
  default: ask
  tools:
    # File operations
    create_file: allow
    delete_file: ask
    move_file: ask
    find_and_replace_code: allow
    open_files: allow
    expand_code_chunks: allow
    expand_folder: allow
    grep: allow
    # Confluence operations
    get_confluence_page: allow
    create_confluence_page: allow
    update_confluence_page: allow
  bash:
    default: ask
    runInSandbox: false
    commands:
      - command: ls.*
        permission: allow
      - command: cat.*
        permission: allow
      - command: echo.*
        permission: allow
      - command: pwd
        permission: allow
      - command: npm.*
        permission: allow
      - command: git status
        permission: allow
```

--------------------------------

### Automated PR Creation Workflow

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

A GitHub Actions workflow that runs Rovo Dev on a schedule to update dependencies and automatically open a pull request.

```yaml
name: Automated Code Updates

on:
  schedule:
    - cron: '0 9 * * 1'  # Every Monday at 9 AM
  workflow_dispatch:

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

      - name: Run Rovo Dev with PR Creation
        id: rovo
        uses: atlassian-labs/rovo-dev-action@v1
        with:
          prompt: "Update all dependencies to their latest compatible versions and fix any breaking changes"
          atlassian_email: ${{ secrets.ATLASSIAN_EMAIL }}
          atlassian_token: ${{ secrets.ATLASSIAN_TOKEN }}
          create_pr: "true"
          github_token: ${{ secrets.GITHUB_TOKEN }}
          pr_title: "chore: weekly dependency updates"
          pr_body: |
            ## Automated Dependency Updates

            This PR was automatically created by Rovo Dev to update dependencies.

            Please review the changes before merging.
          pr_base_branch: "main"
          branch_prefix: "deps/"

      - name: Notify on Success
        if: steps.rovo.outputs.pr_created == 'true'
        run: echo "PR created at ${{ steps.rovo.outputs.pr_url }}"
```

--------------------------------

### Set Organization-Wide Secrets with GitHub CLI

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

To apply secrets across multiple repositories within an organization, use the `--org` and `--visibility` flags with the `gh secret set` command. This is useful for centralizing sensitive information.

```bash
gh secret set ATLASSIAN_EMAIL --org your-org --visibility all
```

```bash
gh secret set ATLASSIAN_TOKEN --org your-org --visibility all
```

--------------------------------

### Conditional PR Workflow

Source: https://context7.com/atlassian-labs/rovo-dev-action/llms.txt

Workflow that triggers on issue labeling, processes requests with Rovo Dev, and posts comments based on the execution result.

```yaml
name: Conditional Rovo Dev Workflow

on:
  issues:
    types: [labeled]

jobs:
  process-issue:
    if: github.event.label.name == 'rovo-dev'
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Process Issue with Rovo Dev
        id: rovo
        uses: atlassian-labs/rovo-dev-action@v1
        continue-on-error: true
        with:
          prompt: |
            Read issue #${{ github.event.issue.number }} and implement
            the requested changes. Follow existing code patterns and
            add appropriate tests.
          atlassian_email: ${{ secrets.ATLASSIAN_EMAIL }}
          atlassian_token: ${{ secrets.ATLASSIAN_TOKEN }}
          create_pr: "true"
          github_token: ${{ secrets.GITHUB_TOKEN }}
          pr_title: "fix: address issue #${{ github.event.issue.number }}"
          pr_body: |
            Closes #${{ github.event.issue.number }}

            This PR was automatically generated by Rovo Dev.

      - name: Comment on Success
        if: steps.rovo.outputs.pr_created == 'true'
        uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: ${{ github.event.issue.number }},
              body: '🤖 Rovo Dev created a PR: ${{ steps.rovo.outputs.pr_url }}'
            })

      - name: Comment on Failure
        if: steps.rovo.outputs.exit_code != '0'
        uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: ${{ github.event.issue.number }},
              body: '⚠️ Rovo Dev encountered an issue processing this request.'
            })
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.