# Work Jira tickets in GUIJam

> Create UI tickets, link one to an element, apply an edit or an AI variant, and see it in Jira with screenshots, the file and line, and the diff.

## Create tickets

Any of these works:

- **In Jira**: **+ Create**, work type **Task**. Describe the change and attach a screenshot or mockup. Images are attached to the developer's prompt as references.
- **Send to GUIJam**: on a ticket, open **•••** and choose **Send to GUIJam**. It then appears under **Sent to GUIJam** in every developer's ticket list.
- **From the running app**: [Report to Jira](#report-to-jira) on any element.
- **From the terminal**, for scripts and demos:

```bash
npx guijam jira create --project WEB --summary "Make the Subscribe button blue" \
  --description-file notes.md --image mockup.png
```

> **Tickets GUIJam can do without AI**
>
> Ask for a text change ("rename the heading to ..."), a fill color from your theme, or a corner radius. Anything structural, such as "add a badge", goes through your AI CLI.

## Link a ticket to an element

1. Click **Select object** in the toolbar, then click the element the ticket is about.
2. In the panel, click **Link a Jira ticket**. Pick from **Assigned to me** or **Sent to GUIJam**, or type a key or words.
3. GUIJam reads the ticket, takes a **before** screenshot of the element, and marks the ticket **In progress**.

![The fine-tune panel with Link a Jira ticket and Report to Jira side by side](https://guijam.francistinao.com/screenshots/jira-row.webp)

![The ticket search with Assigned to me and Sent to GUIJam](https://guijam.francistinao.com/screenshots/jira-picker.webp)

![A spinner reading the ticket from Jira](https://guijam.francistinao.com/screenshots/jira-reading.webp)

## Make the change without AI

1. Choose where the ticket moves on apply, such as **In Review**, and keep **Post before/after screenshots** on.
2. Edit what the ticket asks: the text under **Content**, or **Fill** and **Radius**. The page updates live and nothing is written yet.
3. Click **Apply**. One line is written to your source file, and the notice says when it posts.

![A linked ticket with a text edit ready to apply](https://guijam.francistinao.com/screenshots/jira-linked.webp)

![Applied to App.tsx. Posts to WEB-1 in 10 s unless you undo.](https://guijam.francistinao.com/screenshots/jira-applied.webp)

![Posted to WEB-1, with a link to the ticket](https://guijam.francistinao.com/screenshots/jira-posted.webp)

## Ask your AI CLI instead

1. From the Select panel, click **Ask AI**, or circle the element with **Draw**.
2. Click **Link a Jira ticket** and pick one. If the prompt is empty, GUIJam fills it with the ticket's key, summary and description, and attaches up to four of its images. The prompt is locked with a spinner while that happens. Later, **Use ticket text** fills it again.
3. Edit the prompt if you like, then **Generate**. Pick one of three live variants and click **Use**.
4. It posts to the ticket 10 seconds later, like a direct edit, and says which CLI and model made it.

![The prompt locked while the ticket's text and images fill it](https://guijam.francistinao.com/screenshots/jira-filling.webp)

![The prompt filled from the ticket, with its image attached](https://guijam.francistinao.com/screenshots/jira-filled.webp)

> **Changed your mind?**
>
> Click **Undo** within 10 seconds and nothing is posted: the notice says "Change undone. Nothing was posted to WEB-1." Undo later and the ticket gets a short comment and the status **Reverted**.

## Review the result in Jira

Open the ticket and its **GUIJam** panel. Nobody needs GUIJam installed to see:

- **Status**: Applied, with the source location, for example `src/App.tsx:18`.
- **Who and how**: the person who applied it, when, and "Direct edit, no AI" or the CLI and model.
- **Before and after** screenshots, also attached to the ticket.
- **The diff** of every changed file. Long changes attach a full `.patch`.
- **Open in GUIJam**: on the developer's machine, opens the app with that ticket ready to link again.

The app also adds a comment that mentions the developer, and moves the ticket if they chose a status. Search with JQL:

```txt
guijamStatus = queued                       # waiting for a developer
guijamStatus = applied AND updated >= -7d
guijamFile ~ "Pricing"                      # changes in a given file
```

## Report to Jira

Anyone running the app with GUIJam paired can file a precise ticket:

1. **Select object**, click the element, then **Report to Jira**.
2. Pick the project, write a summary and details, and click **Create ticket**.
3. GUIJam adds a screenshot of the element, its file and line, and the page address. The new ticket is marked **Sent to GUIJam**, so it lands in developers' lists.

![The Report to Jira form on the Order now button](https://guijam.francistinao.com/screenshots/jira-report.webp)
