jira-sync

Seamlessly connect your Anvil development workflow to Jira. Create tickets from conversations, update story status as you work, auto-link git commits to issues, pull ticket context into your Anvil session, and keep your project board in sync with your actual work — without breaking your flow.

What It Does

jira-sync provides deep bidirectional integration with Jira Cloud and Jira Data Center:

• Ticket creation: Create Stories, Tasks, Bugs, and Epics from Anvil conversations with auto-populated fields
• Status transitions: Move tickets through workflow states (To Do → In Progress → In Review → Done) from Anvil
• Commit auto-linking: Detect ticket IDs in branch names and commit messages, auto-post dev panel links
• Context pulling: Load a ticket's description, acceptance criteria, and comments into Anvil context
• Time logging: Log work time against tickets from Anvil session duration
• Sprint management: Move tickets between sprints, check sprint capacity, view active sprint board
• Comment posting: Post code snippets, test results, and session notes as formatted Jira comments
• Field sync: Update custom fields, story points, priority, components, and fix versions

Installation

anvil plugin install jira-sync

Setup

1. Generate a Jira API token at https://id.atlassian.com/manage-profile/security/api-tokens
2. Configure the plugin:

/jira configure --host https://yourorg.atlassian.net --email [email protected] --token ATATT3xXX...

Usage

Pull Ticket Context into Session

/jira load ENG-1234

Create a Bug Ticket

/jira create bug --title "Login fails with SSO on Safari" --project ENG --priority high

Move Ticket to In Progress

/jira transition ENG-1234 "In Progress"

Log Work

/jira log ENG-1234 --time 2h30m --comment "Implemented JWT refresh token rotation"

Post Comment with Code Snippet

/jira comment ENG-1234 --file ./fix-summary.md

Auto-link Current Branch

/jira link-branch

Configuration Options

Option	Description	Default
--host	Jira instance URL	env: JIRA_HOST
--email	Atlassian account email	env: JIRA_EMAIL
--token	Jira API token	env: JIRA_TOKEN
--project	Default project key	auto-detect
--auto-link	Auto-link commits on git push	true

Requirements

• Jira Cloud or Jira Data Center 8.x+
• Atlassian API token (not password)
• Project permissions: Browse Projects, Create Issues, Edit Issues, Transition Issues