> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revolte.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Your First Autonomous Workflow from Jira

> Turn a Jira ticket into a reviewable pull request while Revolte handles planning, isolated execution, and status updates.

Keep your team in Jira while Revolte carries a ticket from ready-to-build work to a reviewable code change.

Need every screen and setting? The detailed [Jira Workflow](https://docs.revolte.ai/workflows/your-first-Autonomous-workflow.md) guide walks through the complete configuration.

> [!NOTE]
>
> **Before you start:** Have permission to install the Revolte app in Jira and a repository you can connect to a Revolte application. If the repository is not connected yet, the setup flow will guide you through it.

**1. Open Autopilot and Connect Jira**

In Revolte, open **Chat** and select **Autopilot**. Install the Revolte app from the Atlassian Marketplace, approve the requested permissions, and choose the Atlassian site your team uses.

![The Revolte Autopilot setup screen for connecting a Jira workspace.](https://mintcdn.com/poddle-54594c3d/PLWOUDjItrGa_UrT/image-v2/agent/dev-agent/autopilot/auto-pilot.png?fit=max\&auto=format\&n=PLWOUDjItrGa_UrT\&q=85\&s=4049836843ba173c3bfd02e5f42707d8)

For the complete connection flow, see [Connect Jira](https://docs.revolte.ai/integrations/project-management/jira.md).

**2. Finish the Application Setup**

Complete the remaining setup checks:

1. **Git Integration** connects the repository Revolte will work in.
2. **Configure Application** records the application's service details.
3. **Commit YAML** saves the `revolte.yml` configuration.

When all four setup items show a green checkmark, select **Configure workflow**.

![The setup checklist completed with a Configure workflow action.](https://mintcdn.com/poddle-54594c3d/a-IrWbKlpJE4bfvq/image-v2/agent/dev-agent/autopilot/ready-for-workflow.png?fit=max\&auto=format\&n=a-IrWbKlpJE4bfvq\&q=85\&s=98d3be83afc567b8585264a7da0d1a42)

**3. Choose Which Jira Tickets Revolte Should Handle**

Open **Automation Configurations** and select **Configure Automation**. Then choose:

* **Workflow:** Select `Developer workflow`.
* **Status mapping:** Choose the Jira status that starts work, such as *To Do*, and the statuses used while work is in progress and complete.
* **Target branch:** Choose where Revolte should propose its changes, such as `qa` or `main`.
* **Model:** Select a model that fits the task—for instance, `Claude Haiku - Fast & efficient`.

![The Configure Workflow Automation form with Jira status mapping, branch, and model settings.](https://mintcdn.com/poddle-54594c3d/a-IrWbKlpJE4bfvq/image-v2/agent/dev-agent/autopilot/configure-workflow-automation.png?fit=max\&auto=format\&n=a-IrWbKlpJE4bfvq\&q=85\&s=d0fdd6fd67d4f1ac88c31512f803fd00)

Save the configuration. It will appear in the active configurations list with its branch and status flow.

**4. Start the Workflow from a Jira Ticket**

Open the ticket in Jira and find **Revolte** in the right sidebar. Under **Select Application**, choose the application Revolte should update.

![A Jira ticket with the Revolte panel and Select Application control in the right sidebar.](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/integrations/jira-3.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=c2536f08c4cf0b6bc9eaa3b5092705ce)

The panel will show **Workflow Triggered**. Select **View Workflow Details** to open the live run. See [Triggering workflows from Jira](https://docs.revolte.ai/integrations/project-management/jira.md#triggering-workflows-from-jira) for more detail.

**5. Follow the Agent Run**

In Revolte, open **Agent runs** to follow the workflow status. When the run completes, open it to review stages such as Sandbox Provisioning, Code Setup, and Token Usage.

![A completed agent run showing its execution stages and summary.](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-8.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=31c530f8d23ebd2b11de108cd3a98c0c)

Revolte performs the work in an isolated sandbox, keeping the run separate from your local machine and shared environments.

**6. Review the Plan and Code Changes**

Open **Artifacts** to read the implementation plan, subtasks, and proposed file changes. Then open **Diff Summary** to compare every line the agent created or modified.

![The Diff Summary view showing files and code changes produced by the agent.](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-10.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=673f66842be3464bc4061b2ba8a4391b)

Review the result before it moves into your normal delivery process.

**7. Review the Pull Request and Preview**

When the agent finishes, Revolte opens a pull request in GitHub or your configured Git provider. Review the proposed changes with your team, then merge when they are ready.

![A pull request created from a completed autonomous workflow and ready for review.](https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/agent/dev-agent/dev-agent-11.png?fit=max\&auto=format\&n=q0Rk3K5lGk3vHIWm\&q=85\&s=620db05cb25fbc9dd88e8bdb79d14ac3)

After merging, select **View Preview** to validate the deployment using your [`revolte.yml`](https://docs.revolte.ai/yaml/overview) configuration.

✓ **Your first autonomous workflow is complete.** The Jira ticket has moved through implementation, code review, and delivery without leaving your team's existing workflow.

## Next steps

* [See the complete Jira workflow guide](https://docs.revolte.ai/workflows/your-first-Autonomous-workflow.md)
* [Manage your Jira integration](https://docs.revolte.ai/integrations/project-management/jira.md)
* [Understand the `revolte.yml` configuration](https://docs.revolte.ai/yaml/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.