Appearance

Open Source CLI Tool

jrJira, but for
AI agents

The CLI that gives AI agents full control over Jira. 600+ commands auto-generated from OpenAPI. JSON in, JSON out. Drop-in skill for Claude Code, Cursor, Codex, and more.

600+Commands
0Prompt eng. needed
100%JSON output
Get Started View on GitHub
$npm install -gjira-jr
$jr workflow move--issuePROJ-123--to"In Progress"--assignme
{"key":"PROJ-123","status":"In Progress","assignee":"me@company.com"}
$jr diff--issuePROJ-123--since2h
[{"field":"status","from":"Open","to":"In Progress"}]

10,000 tokens → 50

--fields, --jq, and --preset strip Jira's bloated responses down to exactly what you need. Your LLM's context window will thank you.

Drop-in Agent Skill

Ships with SKILL.md. Claude Code, Cursor, Codex, Gemini CLI — agents learn the CLI in one read. Zero prompt engineering.

Workflow in Plain English

jr workflow move --issue PROJ-1 --to 'Done' --assign me. No more hunting for transition IDs or account IDs.

Templates

jr template apply bug-report --var summary='Login broken'. Predefined issue patterns with variables. Create from scratch or clone from existing issues.

Real-time Watch

jr watch --jql 'status changed' --interval 30s. NDJSON stream of changes. Build automations that react to Jira in real time.

Diff & Changelog

jr diff --issue PROJ-1 --since 2h. See exactly what changed, when, and by whom. Structured JSON, not a wall of text.

Batch Operations

Pipe a JSON array of commands into jr batch. Run 50 operations in one call. Parallel by default.

Security Built In

Operation policies per profile. Audit logging. Batch limits. Lock down what agents can do — allowed_operations or denied_operations with glob patterns.

600+ Commands

Auto-generated from Jira's OpenAPI spec. Every endpoint is a CLI command, always in sync. Run jr schema to explore.

Why another Jira CLI?

Other CLIs
Human-readable tables. Agents can't parse them. Manual flag lookup. Breaks when Jira updates APIs.
jr
JSON everywhere. Agents read it natively. Ships with SKILL.md — agents learn it in one read. Auto-generated from OpenAPI — never out of date.

See it in action

templates — create issues from patterns
bash
jr template apply bug-report \
  --project PROJ \
  --var summary="Login page 500 on Safari" \
  --var severity=High \
  --var steps="1. Open Safari\n2. Click Login\n3. 500 error"
watch — real-time NDJSON stream
bash
jr watch --jql "project = PROJ AND status changed" --interval 30s
json
{"event":"changed","key":"PROJ-1","field":"status","from":"Open","to":"In Progress","time":"14:32:01"}
{"event":"changed","key":"PROJ-5","field":"assignee","from":"null","to":"alice","time":"14:32:30"}
diff — structured changelog
bash
jr diff --issue PROJ-123 --since 2h --field status,assignee
json
[
  {"field":"status","from":"Open","to":"In Progress","author":"alice","time":"14:20:00"},
  {"field":"assignee","from":"null","to":"alice","time":"14:20:00"}
]