Jira CLI Setup and Usage

This skill provides instructions for installing and using the Jira CLI tool to interact with Jira from the command line.

Quick Reference: Common Pitfalls to Avoid

Before diving into detailed commands, be aware of these critical points:

1. Time Tracking: MUST use jira issue worklog add ISSUE "1m" --new-estimate "1h" - DO NOT use --custom for time tracking
2. Cannot log 0m: Logging "0m" causes server errors - always log at least "1m"
3. Status Names Vary: "Done" may not exist - use exact status name from error message (e.g., "Resolved", "Closed")
4. --no-input Support: Not all commands support --no-input:
   • ✓ Supported: issue edit, issue worklog add
   • ✗ Not supported: issue move, view/list commands
5. Environment Setup: Test jira me --plain first - only source ~/.envrc if auth fails

CRITICAL: Environment Setup

Before running any jira-cli commands, check if the user has already configured their environment.