> ## 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](/workflows/your-first-Autonomous-workflow) guide walks through the complete configuration.

<Info>
  **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.
</Info>

<Steps>
  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/poddle-54594c3d/a-IrWbKlpJE4bfvq/image-v2/agent/dev-agent/autopilot/auto-pilot.png?fit=max&auto=format&n=a-IrWbKlpJE4bfvq&q=85&s=7ddeedbb6215014488c0c4b6c6bb8143" alt="The Revolte Autopilot setup screen for connecting a Jira workspace." width="2880" height="1566" data-path="image-v2/agent/dev-agent/autopilot/auto-pilot.png" />
    </Frame>

    For the complete connection flow, see [Connect Jira](/integrations/project-management/jira).
  </Step>

  <Step title="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**.

    <Frame>
      <img src="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" alt="The setup checklist completed with a Configure workflow action." width="2880" height="1554" data-path="image-v2/agent/dev-agent/autopilot/ready-for-workflow.png" />
    </Frame>
  </Step>

  <Step title="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`.

    <div style={{ maxWidth: "380px", margin: "0 auto" }}>
      <Frame>
        <img src="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" alt="The Configure Workflow Automation form with Jira status mapping, branch, and model settings." width="826" height="1100" data-path="image-v2/agent/dev-agent/autopilot/configure-workflow-automation.png" />
      </Frame>
    </div>

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

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/poddle-54594c3d/q0Rk3K5lGk3vHIWm/image-v2/integrations/jira-3.png?fit=max&auto=format&n=q0Rk3K5lGk3vHIWm&q=85&s=c2536f08c4cf0b6bc9eaa3b5092705ce" alt="A Jira ticket with the Revolte panel and Select Application control in the right sidebar." width="1900" height="844" data-path="image-v2/integrations/jira-3.png" />
    </Frame>

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

  <Step title="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.

    <Frame>
      <img src="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" alt="A completed agent run showing its execution stages and summary." width="1724" height="868" data-path="image-v2/agent/dev-agent/dev-agent-8.png" />
    </Frame>

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

  <Step title="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.

    <Frame>
      <img src="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" alt="The Diff Summary view showing files and code changes produced by the agent." width="1720" height="750" data-path="image-v2/agent/dev-agent/dev-agent-10.png" />
    </Frame>

    Review the result before it moves into your normal delivery process.
  </Step>

  <Step title="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.

    <Frame>
      <img src="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" alt="A pull request created from a completed autonomous workflow and ready for review." width="1234" height="936" data-path="image-v2/agent/dev-agent/dev-agent-11.png" />
    </Frame>

    After merging, select **View Preview** to validate the deployment using your [`revolte.yml`](/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.
  </Step>
</Steps>

## Next steps

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