How it works
Pathmode for Jira is a lightweight, read-only app built on Atlassian Forge. It adds a “Pathmode Intent” panel to the right-hand context area of every Jira issue. When you open an issue, the panel asks Pathmode whether an intent is linked to that issue and, if so, displays its title, current status, and the amount of evidence anchored to it — with a link to open the full specification in Pathmode.
The app sends only Jira identifiers(the site's cloud ID, the issue key, and the site URL) to the Pathmode backend to look up the linked intent. No issue content — summaries, descriptions, comments, attachments, or custom fields — is ever read or transmitted.
Key features
| Feature | What it does |
|---|---|
| Intent panel | The linked intent's objective, outcomes, edge cases, status, and evidence count, in the issue sidebar. |
| One-click to the spec | “Open in Pathmode” jumps straight to the complete intent. |
| Push to Jira | From Pathmode, push an approved intent and a new issue is created with full context and a back-link. |
| Auto-flip to Shipped | When a linked issue moves to Done, the corresponding Pathmode intent flips to Shipped. |
| Read-only | Requests only the read:jira-work scope; never modifies your Jira data. |
Requirements
- A Jira Cloud site where an admin can install apps.
- A free Pathmode account and workspace.
- An Atlassian API token for an account on that Jira site. Pathmode uses it once to verify that your workspace controls the site before the panel is bound to it.
Installation & setup
Request and install the app
Once we have shared the app with your site, a Jira admin installs it from the link we send. Nothing else is needed on the Jira side.
Open any Jira issue
The “Pathmode Intent” panel appears in the issue's right-hand context area.
Connect your workspace
In Pathmode, open Workspace settings → Integrations and complete the Jira section in this order:
- Under Jira, enter your site domain (for example
acme.atlassian.net), the email of your Atlassian account, and an Atlassian API token. Choose Test connection, then save. - Under Atlassian Forge App, paste the same site domain into Link an Atlassian site and choose Link site.
The link step is refused until the connection above it has been verified. This is deliberate: it proves your workspace controls the site before intents are shown on its issues.
Link intents to issues
Push an approved intent from Pathmode to Jira, which creates the issue-to-intent link, or link an existing issue.
Using the app
Open any Jira issue that has a linked Pathmode intent. The “Pathmode Intent” panel shows the intent's title, status, and evidence count. Click “Open in Pathmode” to view the full specification: objective, outcomes, edge cases, and the underlying user evidence. Issues with no linked intent show “No Pathmode intent linked to this issue.”
Before the Jira site has been claimed from a Pathmode workspace, the panel says the site isn't connected yet and links back to Pathmode to finish that step. See Installation & setup, step 3. Until it is connected there is no workspace to resolve intents against, so no issue will show one.
Verifying the app works
Follow these steps to confirm the app is functioning end to end.
Install the app on a Jira Cloud site and connect that site to a Pathmode workspace, per Installation & setup.
In Pathmode, push an approved intent to Jira, or note an already-linked issue. Record the issue key.
Open that issue in Jira. Expected:the “Pathmode Intent” panel shows the intent's title, status, and “N evidence anchored.”
Click “Open in Pathmode.” Expected: the full intent opens in Pathmode.
Open a different issue with no linked intent. Expected:the panel reads “No Pathmode intent linked to this issue.”
Optional. Move a linked issue to Done. Expected: the linked intent flips to Shipped in Pathmode.
The panel has three resting states. Read the wording to tell them apart:
- “This Jira site isn't connected to a Pathmode workspace yet”: installation succeeded, but step 3 of setup is still outstanding. In Pathmode, under Workspace settings → Integrations, verify a Jira connection for the site (domain, email, Atlassian API token), then link the site in the Atlassian Forge App section.
- “No Pathmode intent linked to this issue”: the site is connected and this particular issue simply has no intent linked to it.
- “Unable to load Pathmode intent”: the panel could not reach Pathmode. Retry, then contact support@pathmode.io.
Security & data handling
- Read-only. A single
read:jira-workscope; the app never writes to or modifies Jira. - Minimal egress. Only Jira identifiers (cloud ID, issue key, site URL) reach Pathmode. No issue content, no personal data.
- Authenticated.Requests carry a Forge Invocation Token verified against Atlassian's JWKS.
- EU-hosted. Data is processed and stored in the EU, encrypted in transit (TLS 1.2+) and at rest (AES-256). Install records are deleted on uninstall.
See our Privacy Policy and Trust Center.
Support
Questions or issues? Email support@pathmode.io or visit our support page.