# Jira CLI

> Manage Jira issues via command line - read issues, query by filters, create/update issues, add comments, and close issues after work completion. Use when this capability is needed.

- Skill: `tomevault-io/jira-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/jira-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/jira-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/jira-cli

---


# 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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/xdg) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->