Jira Extension - Quick Start

🚀 Quick Commands

Slash Commands

# Your open issues
/jira

# All your issues
/jira-mine

# View specific issue
/jira-view SRVKP-1234

# Search
/jira-search priority=Blocker

# Blocked issues
/jira-blocked

# Recently viewed
/jira-recent

✨ Auto-Detection

Just paste issue keys - they’ll be auto-viewed!

# Single issue
SRVKP-1234

# Multiple issues  
SRVKP-1234 KONFLUX-456

# In context (passed through)
"Working on SRVKP-1234 which relates to KONFLUX-456"

📋 Common Workflows

Morning Standup

# What did I work on?
/jira-recent

# What am I working on?
/jira

# Any blockers?
/jira-blocked

Issue Review

# Someone sends you: "Can you look at SRVKP-1234?"
# Just paste it:
SRVKP-1234
# → Auto-views the issue

Search and Filter

# Critical bugs
/jira-search type=Bug AND priority=Critical

# Issues in epic
/jira-search "Epic Link"=SRVKP-1000

# Recently updated
/jira-search updated >= -7d

🎯 Tool Actions

All actions available through natural language:

Read (No Approval)

"What's my Jira username?"              → me
"Show my open issues"                   → list
"Show SRVKP-1234"                       → view
"Search for blocker issues"             → search

Write (Requires Approval)

"Create a bug for X"                    → create ⚠️
"Assign SRVKP-1234 to me"              → update ⚠️
"Add comment to SRVKP-1234"            → comment ⚠️
"Move SRVKP-1234 to In Progress"       → transition ⚠️

🔑 Supported Projects

Works with any Jira project:

• SRVKP (Tekton Pipelines)
• KONFLUX (Konflux)
• RHCLOUD (Cloud Services)
• Any [A-Z]{2,}-\d+ pattern

📊 Filter Examples

By Assignee

"Show issues assigned to alice"
→ list, assignee=alice

"Show my issues"
→ list, assignee=me

By Status

"Show To Do issues"
→ list, status="To Do"

"Show open issues" (not Done)
→ list, status=~Done

By Type

"Show bugs"
→ list, type=Bug

"Show bugs and tasks"
→ list, type="Bug,Task"

By Priority

"Show critical issues"
→ list, priority=Critical

"Show high priority items"
→ list, priority="Critical,Major"

By Epic

"Show issues in epic SRVKP-1000"
→ list, epic=SRVKP-1000

Combined

"Show my high priority bugs not done"
→ list, assignee=me, type=Bug, priority="Critical,Major", status=~Done

🎨 Custom Rendering

Issues are displayed with color-coded status:

• 🟢 Done/Closed - Success (green)
• 🔵 In Progress/Review - Accent (blue)
• 🔴 Blocked/Waiting - Error (red)
• ⚪ To Do - Muted (gray)

Priorities are also color-coded:

• 🔴 Blocker/Critical - Error (red)
• 🟡 Major/High - Warning (yellow)
• ⚪ Minor/Trivial - Dim (gray)

⚠️ Approval Dialogs

All write operations show a confirmation dialog:

┌─────────────────────────────────┐
│ Create Jira Issue?              │
│                                 │
│ Type: Bug                       │
│ Summary: "CI tests failing"     │
│ Priority: Major                 │
│                                 │
│ This will create a new issue    │
│ in Jira.                        │
│                                 │
│ [Yes] [No]                      │
└─────────────────────────────────┘

You must confirm before any change is made!

🔍 JQL Examples

For /jira-search command:

# Your open issues
/jira-search assignee=currentUser() AND status!=Done

# Blocker issues
/jira-search priority=Blocker

# Recent updates
/jira-search updated >= -7d

# Issues in project
/jira-search project=SRVKP AND status!=Done

# Epic children
/jira-search "Epic Link"=SRVKP-1000

# Unassigned tasks
/jira-search type=Task AND assignee=EMPTY

# Complex query
/jira-search project=SRVKP AND priority IN (Critical,Blocker) AND status!=Done ORDER BY updated DESC

🏃 Quick Tips

1. Just paste issue keys - fastest way to view
2. Use /jira for daily standup prep
3. Use /jira-recent to see what you’ve looked at
4. Search with JQL for complex queries
5. Watch for approval dialogs on write operations
6. Use “me” as assignee to refer to yourself

📚 Full Documentation

See README.md for complete documentation including:

• All tool parameters
• Error handling
• Configuration
• Integration patterns
• Troubleshooting

🐛 Troubleshooting

Extension not loading?

# Check pi output for errors
pi

Authentication issues?

# Test jira CLI
jira me

# Check config
cat ~/.config/.jira/.config.yml

# Check token
passage show redhat/issues/atlassian/token

Network errors?

• Verify VPN connection
• Try: jira me from terminal

Slash commands not working?

• Type exactly: /jira (no extra spaces)
• Check command exists: type /j and hit Tab

🎉 Have Fun!

The extension makes Jira management fast and seamless. No more switching to the browser for every little thing!