name	Jira
description	Jira issue management for Red Hat issues.redhat.com. USE WHEN user mentions jira, ticket, issue, epic, sprint OR references Jira issue keys (SRVKP-1234, SRVCOM-456) OR wants to manage issue workflows, assignments, tracking OR needs to integrate Jira with org-mode notes and TODOs.

Jira

Interactive command-line management of Jira issues, epics, and sprints for Red Hat's issues.redhat.com. Minimizes reliance on the web interface while providing comprehensive issue tracking, workflow automation, and integration with org-mode notes.

Workflow Routing

When the user's request matches specific Jira operations, route to the appropriate workflow:

Workflow	Trigger	File
View	"view issue", "show ticket", "get details", issue key mentioned	`workflows/View.md`
List	"list issues", "show my tickets", "what's assigned to me"	`workflows/List.md`
Create	"create issue", "new ticket", "file bug", "open task"	`workflows/Create.md`
Update	"update issue", "change status", "assign to", "move to"	`workflows/Update.md`
Comment	"add comment", "comment on", "reply to issue"	`workflows/Comment.md`
Search	"search for", "find issues", "JQL query", complex filtering	`workflows/Search.md`
LinkToNote	"link to note", "create note for issue", "document issue"	`workflows/LinkToNote.md`
Sprint	"sprint", "current sprint", "add to sprint"	`workflows/Sprint.md`
Transition	"transition", "workflow", "move issue to", state changes	`workflows/Transition.md`

Key Features

Issue Management

View detailed issue information
Create new issues (bugs, tasks, stories, epics)
Update issue fields (status, assignee, priority, labels)
Add comments and work logs
Attach files and links

Advanced Filtering

List issues by assignee, reporter, project
Filter by status, priority, type
Time-based filtering (created, updated, resolved)
Custom JQL queries for complex searches
Save and reuse common filters

Sprint & Epic Management

List current, previous, and future sprints
Add/remove issues from sprints
Track epic progress
Filter issues by epic or sprint

Integration with Org-Mode

Link Jira issues to org-mode notes
Create TODOs from Jira issues
Reference issues in project planning
Track issue progress in daily notes

Common Jira Projects

Red Hat Jira projects you commonly work with:

SRVKP: Tekton Pipelines (Service, Kubernetes Pipelines)
SRVCOM: Common services and infrastructure
RHCLOUD: Red Hat Cloud services

Best Practices

1. Use Plain Output for Scripting

Always use --plain flag when the output will be processed:

jira issue list --plain -a $(jira me) -s "To Do"

2. Use JQL for Complex Queries

For advanced filtering, use JQL (Jira Query Language):

jira issue list --jql "project = SRVKP AND assignee = currentUser() AND status != Done ORDER BY priority DESC"

3. Set Default Project

Configure your most-used project in ~/.config/.jira/.config.yml:

project:
  key: SRVKP

4. Integrate with Workflows

Create org-mode TODOs for critical issues
Link issues to notes for context
Use jira commands in scripts and automation

5. Common Filters

Save time with these common queries:

My open issues: -a $(jira me) -s ~Done
High priority bugs: -t Bug -p High,Highest
Recently updated: --updated-after -7d
Blocked issues: -s Blocked,Waiting

Configuration

Jira Config Location

~/.config/.jira/.config.yml

Key Configuration Options

server: https://issues.redhat.com
login: Your Red Hat email
project.key: Default project (e.g., SRVKP)
installation: local (for on-premise)
auth_type: bearer (using API token from passage)

API Token

Managed automatically via Nix wrapper using passage:

passage show redhat/issues/token/kyushu

Jira CLI Quick Reference

Issue Operations

# View issue
jira issue view SRVKP-1234

# Create issue
jira issue create

# List issues
jira issue list -a $(jira me)

# Update issue
jira issue move SRVKP-1234 "In Progress"

# Add comment
jira issue comment add SRVKP-1234

Filtering Options

-a, --assignee    Filter by assignee
-r, --reporter    Filter by reporter
-t, --type        Filter by type (Bug, Task, Story, Epic)
-s, --status      Filter by status
-p, --priority    Filter by priority
-l, --label       Filter by labels
--created-after   Issues created after date
--updated-after   Issues updated after date
--jql            Custom JQL query

Output Options

--plain          Plain text output (AI-friendly)
--no-truncate    Don't truncate long fields
--columns        Specify columns to display
--order-by       Sort order
--reverse        Reverse sort order

Issue Types

Common issue types in Red Hat Jira:

Bug: Software defects
Task: General work items
Story: User stories for features
Epic: Large features or initiatives
Spike: Research or investigation work
Sub-task: Child issues of other issues

Issue Priorities

Blocker: Blocks development/testing
Critical: System crashes, data loss
Major: Major functionality broken
Minor: Minor functionality issue
Trivial: Cosmetic issues

Workflow States

Common workflow transitions:

To Do → In Progress: Start work
In Progress → Code Review: Submit for review
Code Review → QE Review: Pass to QA
QE Review → Done: Complete
Any → Blocked: Mark as blocked

Integration Patterns

1. Daily Standup Prep

# Get issues I worked on yesterday
jira issue list --plain -a $(jira me) --updated-after -1d

# Get issues I'm working on today
jira issue list --plain -a $(jira me) -s "In Progress"

2. Create TODO from Issue

# View issue and create corresponding TODO
jira issue view SRVKP-1234 --plain
# Then use TODOs skill to add to org-mode

3. Link to Org Notes

# View issue and create denote note with issue link
jira issue view SRVKP-1234
# Create note using Notes skill with Jira URL

4. Sprint Planning

# List current sprint issues
jira sprint list --current

# Add issue to sprint
jira sprint add SPRINT-123 SRVKP-1234

Examples

Example 1: View a specific Jira issue

User: "Show me SRVKP-9243"
→ Invokes View workflow
→ Displays issue details (title, status, assignee, description)
→ Shows recent comments and attachments
→ Provides issue URL for web access

Example 2: List my open issues

User: "What are my open Jira tickets?"
→ Invokes List workflow
→ Filters by current user and excludes Done status
→ Shows table of open issues with priority and status
→ Sorted by priority (highest first)

Example 3: Create a bug report

User: "Create a bug for the failing CI tests"
→ Invokes Create workflow
→ Prompts for project (defaults to SRVKP)
→ Sets type to Bug
→ Asks for summary and description
→ Creates issue and returns issue key (e.g., SRVKP-9999)

Example 4: Link Jira issue to org-mode note

User: "Create a note for SRVKP-9243"
→ Invokes LinkToNote workflow
→ Fetches issue details from Jira
→ Creates denote note with issue info
→ Adds Jira URL to note
→ Links note back in Jira comment (optional)

Tips

Use aliases for common commands: Add shell aliases for frequent operations
Combine with grep/jq: Filter jira output for specific data
Use --plain in scripts: Ensures consistent, parseable output
Save JQL queries: Keep complex queries in notes for reuse
Set project defaults: Configure common projects to reduce typing
Use issue keys in commit messages: Link commits to issues
Comment from CLI: Add quick updates without opening browser
Track time efficiently: Log work time from command line

Troubleshooting

Authentication Issues

Verify API token in passage: passage show redhat/issues/token/kyushu
Check config: cat ~/.config/.jira/.config.yml
Test connection: jira me

Permission Errors

Verify you're on Red Hat VPN if required
Check project permissions in web UI
Ensure API token has correct scopes

No Issues Found

Verify project key is correct
Check filter criteria (status, assignee, etc.)
Try with --jql for direct query
Use --debug flag to see API calls

Related Skills

TODOs: Create TODOs from Jira issues
Notes: Document issues in denote notes
Git: Reference issues in commits
Email: Email issue summaries to team

Learn More

Jira CLI GitHub: https://github.com/ankitpokhrel/jira-cli
Red Hat Jira: https://issues.redhat.com
JQL Reference: https://issues.redhat.com/secure/JiraJQLHelp.jspa

Install Skill

SKILL.md