48 lines
1.5 KiB
Markdown
48 lines
1.5 KiB
Markdown
---
|
|
name: jira-cli
|
|
description: Manage Jira issues via command line - read issues, query by filters, create/update issues, add comments, and close issues after work completion.
|
|
---
|
|
|
|
# jira-cli: Command-Line Jira Management
|
|
|
|
Use jira-cli when interacting with Jira. Assume jira-cli already installed/configured.
|
|
|
|
**Project flag:** Always use `-p PROJ` to specify project explicitly (don't rely on defaults)
|
|
|
|
## When to Use
|
|
|
|
**Use for:** Reading issues, querying (status/priority/assignee filters), creating/updating issues, adding comments, closing after work complete
|
|
|
|
**Ask user for web UI:** Attachments/images, visual board operations (can't do from CLI)
|
|
|
|
## Core Pattern: Work on Issue
|
|
|
|
```bash
|
|
jira issue view -p PROJ PROJ-123 # Read requirements
|
|
jira issue assign PROJ-123 $(jira me) # Assign to user
|
|
# ... implement ...
|
|
jira issue comment add PROJ-123 "Fixed in $(git rev-parse --short HEAD)"
|
|
jira issue move PROJ-123 "Done" # Close when complete
|
|
```
|
|
|
|
## Efficient Extraction
|
|
|
|
Extract only needed fields to minimize context usage:
|
|
|
|
```bash
|
|
# Get specific fields only
|
|
jira issue view -p PROJ PROJ-123 --raw | jq -r '.fields.status.name'
|
|
|
|
# List keys for iteration
|
|
jira issue list -p PROJ --plain --no-headers --columns KEY
|
|
```
|
|
|
|
## When to Load Detailed Guide
|
|
|
|
Load [jira-cli reference guide](./reference/jira-cli-reference.md) for:
|
|
- Command syntax and flags
|
|
- Query patterns and JQL filtering
|
|
- Output format options
|
|
- User intent → command mapping
|
|
- Git integration patterns
|