# Codegeist 2026 judging guide

> Install GUIJam for Jira, run the demo app, pair it, seed four tickets and work them, three with no AI tool needed. Every step for judging the entry.

GUIJam for Jira is GUIJam's entry in Atlassian Codegeist 2026, category **Apps for Software Teams**, with the bonus prize **Best app with Atlassian MCP**. This page walks you through trying it end to end. You need a Jira Cloud site where you're an admin, and Node `>=22.12`. No AI tool or API key is needed for the main path.

## Install the app

Open the [GUIJam for Jira installation link](https://developer.atlassian.com/console/install/9f6e7bd4-561f-42c1-967c-534533ca84fd?signature=AYABeNHZxmIIzqskV6bj6ZDb2BwAAAADAAdhd3Mta21zAEthcm46YXdzOmttczp1cy13ZXN0LTI6NzA5NTg3ODM1MjQzOmtleS83MDVlZDY3MC1mNTdjLTQxYjUtOWY5Yi1lM2YyZGNjMTQ2ZTcAuAECAQB4CxqLTo9l4lqXuFjNim1xJM%2Bp%2F3TVP9xHS2BrU5DRRucB9X7SgA05cnObTkvhYN1xbQAAAH4wfAYJKoZIhvcNAQcGoG8wbQIBADBoBgkqhkiG9w0BBwEwHgYJYIZIAWUDBAEuMBEEDNEhzAe7TPWDBVqk6wIBEIA7keQSd6CapbYmtUGdkeKKsGD9awYJ3ooCpMpwMF2EDUNbpBp%2F9PeiHpLYzLpKRCnH1ToDtNvaJyOei0kAB2F3cy1rbXMAS2Fybjphd3M6a21zOmV1LXdlc3QtMTo3MDk1ODc4MzUyNDM6a2V5LzQ2MzBjZTZiLTAwYzMtNGRlMi04NzdiLTYyN2UyMDYwZTVjYwC4AQICAHi9bVMAkme4qVQX1fQHo6ePw3H40A7cGfz7yrmSfBWMXgEaeJ%2BkdCobmSDv47DLtIySAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMGEExVBpjK5bbUYmTAgEQgDvy5cWJv19sweBbrSFr5C3xdwywv%2BBv20pRtihL1aMr7o8uQnVvR9vasue1xGfDidyWyh8RzUzmiGXFBQAHYXdzLWttcwBLYXJuOmF3czprbXM6dXMtZWFzdC0xOjcwOTU4NzgzNTI0MzprZXkvNmMxMjBiYTAtNGNkNS00OTg1LWI4MmUtNDBhMDQ5NTJjYzU3ALgBAgIAeDYASx0XCjkny4iLV6vz%2BKtEGSGT6kdt0QRpkn6D%2FlVEAWqyfoA4bYp55SbOGUdCdOkAAAB%2BMHwGCSqGSIb3DQEHBqBvMG0CAQAwaAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAwmXimEV%2FsYgm0GihwCARCAO2yT52i7N%2B%2BDNBN%2F2F87pJutoitrvTBVazhVeMuRbv%2BmP8xV9sDbTccsGcHKl%2BfdohjSFjjtL%2BQGx983AgAAAAAMAAAQAAAAAAAAAAAAAAAAAKlWUN4JXPX85evX3RKxCVz%2F%2F%2F%2F%2FAAAAAQAAAAAAAAAAAAAAAQAAADLbFlcEhVS0TGlPnle4N%2FWi6ZPs4%2FxogfU6%2BLKHwDp0vbTyhpPRk4JYHRWIvoxpoJGa%2F4o%2Fn8CSg1cuvGh0MKv91WQ%3D\&product=jira) and install the app on your site. Create a Kanban space if you need one and note its key, such as `WEB`. A new space may need a minute before you can create work in it.

## Run the demo app

```bash
git clone https://github.com/francistinao/guijam-jira-demo
cd guijam-jira-demo
pnpm install
pnpm dev
```

Open the address Vite prints. The GUIJam toolbar is at the bottom right.

## Pair GUIJam with Jira

In Jira, create any ticket, open it, click the **GUIJam** button under its title, and choose **Pair GUIJam**. Run the command it shows in the demo folder:

```bash
npx guijam jira pair gjp_...
```

## Create the demo tickets

```bash
pnpm seed:jira --project WEB
```

This creates four tickets with screenshots. Three of them need no AI.

## Work a ticket

1. In the app, choose **Select object** and click **Subscribe**.
2. Click **Link a Jira ticket**, then **Make the Subscribe button blue and pill-shaped**.
3. Under **On apply, move to**, pick a status such as In Review.
4. Set **Fill** to `ocean` and **Radius** to `full`, then **Apply**.
5. About 10 seconds later, open the ticket in Jira. The GUIJam panel shows the before and after screenshots, `src/App.tsx` with its line, the diff, and the moved status.

The other tickets work the same way: select the heading and type the new text under **Content**, or select a plan name, which GUIJam finds in `src/plans.ts`. The badge ticket needs an AI coding CLI and **Ask AI**.

## Try the rest

- **Undo** within 10 seconds of applying, and nothing is posted.
- **Report to Jira** from any element, then open the new ticket.
- Search JQL `guijamStatus = applied`.
- With Rovo on and external MCP access allowed, ask an agent "Which UI tickets are waiting for GUIJam?". See [Agents and MCP](https://guijam.francistinao.com/docs/jira/mcp).

## How it meets the Forge requirement

| Module                              | Role                                                                                           |
| ----------------------------------- | ---------------------------------------------------------------------------------------------- |
| `webtrigger`                        | The bridge that GUIJam on a developer's machine calls, authenticated by a hashed pairing token |
| `jira:issuePanel` (UI Kit)          | Results, status, pairing and device revocation                                                 |
| `jira:issueAction` (UI Kit)         | Send to GUIJam                                                                                 |
| `jira:entityProperty`               | JQL: `guijamStatus`, `guijamFile`, `guijamAppliedAt`                                           |
| `rovo:mcp` and two `action` modules | Read-only MCP tools                                                                            |
| Forge KVS                           | Pairing hashes, results, idempotency keys and rate limits                                      |

The app makes no external calls and no AI calls, and no Atlassian credentials leave Jira. See [Security and privacy](https://guijam.francistinao.com/docs/jira/security).

## Built during the submission period

GUIJam's repository began on November 17, 2026, after the submission period opened on October 27, 2026, so all of GUIJam, including this Jira integration, was built during the period. The source is at [github.com/francistinao/gui-jam](https://github.com/francistinao/gui-jam), with the Forge app in `integrations/jira-forge`.

## Limits

- Jira Cloud only. Forge doesn't run on Data Center.
- A developer runs their app's dev server with GUIJam, a dev-only tool.
- The fourth demo ticket needs an AI coding CLI such as Claude Code.
