Jira Integration

Authentication: API Token #

All Jira operations require a Jira API Token.

Log in to your Atlassian account.
Go to https://id.atlassian.com/manage-profile/security/api-tokens.
Click Create API token.
Give your token a descriptive label (e.g., “Agilien”) and click Create.
Important: Copy the token immediately. You will not be able to see it again.

Sync to Jira (Export) #

This feature exports the project plan from the app to your Jira instance. It will create new issues or update existing ones if they were previously synced.

Click the Sync with Jira button in the main header.
In the modal, paste your Jira API Token.
Enter the Jira Project Key (e.g., “PROJ”) of the target project.
(Optional) Acceptance Criteria Field: If your Jira project has a dedicated custom field for acceptance criteria, enter its ID here (e.g., customfield_10021). This keeps the main description field cleaner. If left blank, acceptance criteria will be appended to the description of the Story.
Test Token: It’s highly recommended to click Test Token first to ensure your credentials are valid.
Click Start Sync.

The log window will show the progress as the app creates or updates Epics, Stories, and Sub-Tasks. Once synced, the Jira Keys (e.g., “PROJ-123”) will appear next to the item titles in the hierarchy view. Diagram attachments will also be uploaded as SVG files to their corresponding Jira issues.

Import from Jira #

This feature imports an existing project from Jira, allowing you to analyze its structure or generate diagrams for its issues. This will replace any unsaved project currently in the app.

Click the Import from Jira button in the main header.
Paste your Jira API Token and the Jira Project Key you want to import.
Click Start Import.

The app will fetch all issues from the specified project and reconstruct the Epic -> Story -> Sub-Task hierarchy. It will even import your SVG attachments.