incidentfox Jira Issue Tracking
Authentication
Set these environment variables:
JIRA_URL— Your Jira instance URL (e.g.,https://yourcompany.atlassian.net)JIRA_EMAIL— Your Atlassian account emailJIRA_API_TOKEN— API token from https://id.atlassian.com/manage-profile/security/api-tokens
Available Scripts
All scripts are in .claude/skills/jira-tasks/scripts/
search_issues.py - Search with JQL
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "JQL_QUERY" [--max-results N]
# Examples:
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "type = Bug AND status != Done AND created >= -7d"
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "labels = question AND created >= -30d" --max-results 50
python .claude/skills/jira-tasks/scripts/search_issues.py --jql "assignee = currentUser() AND status = 'In Progress'"
Client Library Functions
The jira_client.py module provides:
| Function | Purpose |
|---|---|
search_issues(jql, max_results) |
Search issues using JQL |
get_issue(issue_key) |
Get issue details |
create_issue(project, summary, ...) |
Create a new issue |
update_issue(issue_key, fields) |
Update an existing issue |
add_comment(issue_key, comment) |
Add a comment to an issue |
JQL Quick Reference
Common Patterns
# Recent bugs
type = Bug AND created >= -7d ORDER BY created DESC
# Open tasks
status != Done AND status != Closed
# By label
labels IN ("helpdesk", "question")
# Text search
summary ~ "timeout" OR description ~ "timeout"
# Assigned to me
assignee = currentUser() AND status != Done
# Stale issues
updated <= -90d AND status != Done
Operators
| Operator | Meaning | Example |
|---|---|---|
| = | Equals | status = Done |
| != | Not equals | status != Done |
| ~ | Contains text | summary ~ "error" |
| IN | In list | status IN ("Open", "In Progress") |
| >= | Greater/equal | created >= -7d |
| ORDER BY | Sort | ORDER BY created DESC |
Common Workflows
1. Find Related Issues
python search_issues.py --jql "text ~ 'authentication timeout' AND created >= -30d"
2. Create a Follow-up Task
from jira_client import create_issue
create_issue(
project="HELP",
summary="Update knowledge base — refund policy",
description="A customer asked about the refund timeline and our docs were outdated.",
issue_type="Task",
priority="Medium",
)
3. Track Question Patterns
python search_issues.py --jql "labels = helpdesk AND created >= -30d" --max-results 100
Quick Reference
| Goal | Command |
|---|---|
| Search issues | search_issues.py --jql "type = Bug" |
| Recent issues | search_issues.py --jql "created >= -7d" |
| By label | search_issues.py --jql "labels = helpdesk" |