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

# Jira Tool

> The Jira Tool connects DinoAI to your Jira tickets, helping implement features and fix issues based on requirements stored in your task management system.

export const Arcade = ({src, title}) => <div style={{
  position: 'relative',
  paddingBottom: 'calc(56.2225% + 41px)',
  height: 0,
  width: '100%'
}}>
    <iframe src={src} title={title} frameBorder="0" loading="lazy" allow="clipboard-write" allowFullScreen style={{
  position: 'absolute',
  top: 0,
  left: 0,
  width: '100%',
  height: '100%',
  colorScheme: 'light'
}} />
  </div>;

The Jira Tool allows DinoAI to work with your Jira tickets — reading task requirements and issue details, and creating, updating, and commenting on issues directly from your development workflow.

This tool connects development work to Jira, enabling DinoAI to understand requirements, resolve tickets, implement features, and keep issue status and discussion up to date as work progresses.

<Info>
  **Requires Jira integration.** Before using this tool, make sure you've connected your Jira account in Paradime. See [Connecting Jira](/integrations/jira/index) to Paradime for setup instructions.
</Info>

#### Capabilities

The Jira Tool gives DinoAI both read and write access to your Jira issues. Specifically, it can:

* **Fetch issue details** using issue keys or URLs, extracting task requirements and acceptance criteria
* **List and search issues** filtered by project, assignee, status, label — or a raw JQL query
* **Create new issues** in a project, with summary, description, issue type, priority, and labels
* **Update existing issues** — change the summary, description, priority, assignee, or labels, and transition issue status (e.g. move a ticket to "In Progress" or "Done") by naming the target status
* **Add comments** to issues, e.g. to document progress or record what was implemented

<Info>
  Every issue DinoAI creates is automatically tagged with a `dinoai` label and includes a "Created by DinoAI" attribution line in its description, so tickets filed by the agent are always identifiable.
</Info>

#### Using the Jira Tool

1. Open DinoAI in the right panel of the Code IDE
2. Reference the Jira issue key or URL you want to work with (e.g., `FEAT-123` or a full Jira URL), or describe the issue you want DinoAI to find or create
3. Add your prompt describing what you want DinoAI to do — read the ticket, implement it, update its status, file a new issue, or leave a comment
4. Grant permission when DinoAI asks to access Jira — each Jira action requires your approval before it runs
5. Review and implement DinoAI's suggested actions

<Arcade src="https://demo.arcade.software/E3Ih9rBz9Aw06XAsKh7b?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Jira Tool" />

#### Example Use Cases

**Implementing a Feature from a Ticket**

**Prompt**

```
I need to implement the feature described in FEAT-456. Can you help me get started?
```

**Result:** DinoAI extracts the requirements from the ticket, suggests an implementation approach, and helps create the necessary models or code changes to satisfy the acceptance criteria.

**Resolving a Production Issue**

**Prompt**

```
I have a production branch that failed this morning. Details are in Jira ticket PROD-123. Can you help me resolve it?
```

**Result:** DinoAI accesses the ticket details, analyzes the error information, and guides you through creating a fix branch, modifying the necessary files, and testing the solution.

**Filing a Bug You Just Found**

**Prompt**

```
The revenue model double-counts refunds issued in a different month than the original order. Create a bug ticket in the DATA project with the details and mark it as High priority.
```

**Result:** DinoAI creates a new issue in the DATA project with a clear summary and description of the bug, sets the issue type and priority, and returns the new issue key and a link to it.

**Closing the Loop After Finishing Work**

**Prompt**

```
I've merged the fix for FEAT-456. Add a comment summarizing what was changed and move the ticket to Done.
```

**Result:** DinoAI posts a comment on FEAT-456 describing the implemented changes, then transitions the issue to the "Done" status.

**Reviewing Your Open Work**

**Prompt**

```
List my open tickets in the DATA project so we can decide what to pick up next.
```

**Result:** DinoAI lists the open issues assigned to you in the DATA project with their status and priority, so you can choose the next piece of work — and start implementing it in the same session.

#### Working with Other Tools

The Jira Tool works well alongside DinoAI's other capabilities to support your full development workflow:

* Combine with the **Terminal Tool** to create branches using Jira-based naming conventions (e.g., `feature/JIRA-123`) and reference ticket IDs in commit messages
* Combine with the **Confluence Tool** to cross-reference ticket requirements against linked specification pages
* Use alongside **Git Lite** to commit implementation work that traces back to a specific Jira issue — then have DinoAI comment on the ticket and transition it once the work is merged

You'll need appropriate Jira permissions for the actions you ask DinoAI to perform — creating, updating, or commenting on issues requires the corresponding permissions in your Jira project. DinoAI will request your approval each time it needs to read from or write to Jira.

#### Best Practices

* **Use exact ticket references** — Include the precise Jira issue key or URL in your prompt to ensure DinoAI accesses the correct ticket
* **Ensure ticket quality** — DinoAI works best with well-documented tickets that include clear descriptions, acceptance criteria, and relevant context
* **Verify suggestions** — Always review DinoAI's interpretation of requirements before implementing, especially for complex or ambiguous tickets
* **Review writes before approving** — When DinoAI creates, updates, or comments on an issue, check the proposed content in the approval prompt; nothing is written to Jira until you approve it
* **Use status names, not transition IDs** — To move a ticket, just name the target status (e.g. "In Progress", "Done"); DinoAI finds and executes the matching workflow transition automatically
* **Combine with the Terminal Tool** — Let DinoAI help with the full workflow from implementation to testing, using the ticket as the source of truth throughout


## Related topics

- [jira-backlog-agent](/guides/programmable-agents/jira-backlog-agent.md)
- [Fixing Errors with Jira](/products/dino-ai/copilot/use-cases/fixing-errors-with-jira.md)
- [Terminal Tool](/products/dino-ai/tools-and-features/terminal-tool.md)
- [Required Jira Permissions](/integrations/jira/required-jira-permissions.md)
- [Notion Tool](/products/dino-ai/tools-and-features/notion-tool.md)