tools-only Jira Communication
CLI scripts for Jira operations using uv run. All scripts support --help, --json, --quiet, --debug.
Auto-Trigger
Trigger when user mentions:
- Jira URLs:
https://jira.*/browse/*,https://*.atlassian.net/browse/* - Issue keys:
PROJ-123,NRS-4167
When triggered by URL → extract issue key → run jira-issue.py get PROJ-123
Auth Failure Handling
When auth fails, offer: uv run scripts/core/jira-setup.py (interactive credential setup)
Scripts
| Script | Purpose |
|---|---|
scripts/core/jira-setup.py |
Interactive credential config |
scripts/core/jira-validate.py |
Verify connection |
scripts/core/jira-issue.py |
Get/update issue details |
scripts/core/jira-search.py |
Search with JQL |
scripts/core/jira-worklog.py |
Time tracking |
scripts/core/jira-attachment.py |
Download attachments |
scripts/workflow/jira-create.py |
Create issues |
scripts/workflow/jira-transition.py |
Change status |
scripts/workflow/jira-comment.py |
Add comments |
scripts/workflow/jira-sprint.py |
List sprints |
scripts/workflow/jira-board.py |
List boards |
scripts/utility/jira-user.py |
User info |
scripts/utility/jira-fields.py |
Search fields |
scripts/utility/jira-link.py |
Issue links |
Critical: Flag Ordering
Global flags MUST come before subcommand:
# Correct: uv run scripts/core/jira-issue.py --json get PROJ-123
# Wrong: uv run scripts/core/jira-issue.py get PROJ-123 --json
Quick Examples
uv run scripts/core/jira-validate.py --verbose
uv run scripts/core/jira-search.py query "assignee = currentUser()"
uv run scripts/core/jira-issue.py get PROJ-123
uv run scripts/core/jira-worklog.py add PROJ-123 2h --comment "Work done"
uv run scripts/workflow/jira-transition.py do PROJ-123 "In Progress" --dry-run
Related Skills
jira-syntax: For descriptions/comments. Jira uses wiki markup, NOT Markdown.
References
references/jql-quick-reference.md- JQL syntaxreferences/troubleshooting.md- Setup and auth issues
Authentication
Cloud: JIRA_URL + JIRA_USERNAME + JIRA_API_TOKEN
Server/DC: JIRA_URL + JIRA_PERSONAL_TOKEN
Config via ~/.env.jira or env vars. Run jira-validate.py --verbose to verify.