jira-jr
Jira CLI built for AI agents — pure JSON output, semantic exit codes, 600+ auto-generated commands, and built-in jq filtering.
Give your AI agent (Claude Code, Cursor, Copilot, or custom bots) reliable, token-efficient access to Jira Cloud.
Install
pip install jira-jr
# or
uv tool install jira-jr
Why jr?
# Full Jira response: ~10,000 tokens
jr issue get --issueIdOrKey PROJ-123
# With jr's filtering: ~50 tokens
jr issue get --issueIdOrKey PROJ-123 --fields key,summary --jq '{key: .key, summary: .fields.summary}'
- All output is JSON — stdout for data, stderr for errors, always
- Semantic exit codes — 0=ok, 2=auth, 3=not_found, 5=rate_limited — agents can branch without parsing
- 600+ commands from the official Jira OpenAPI spec, synced daily
- Batch operations — N API calls in one process via
jr batch - Self-describing —
jr schema --compactlets agents discover commands at runtime - Workflow helpers —
jr workflow transition --to "Done"resolves IDs automatically
Quick start
# Configure
jr configure --base-url https://yoursite.atlassian.net --token YOUR_API_TOKEN
# Search issues
jr search search-and-reconsile-issues-using-jql \
--jql "project = PROJ AND status = 'In Progress'" \
--jq '[.issues[] | {key, summary: .fields.summary}]'
# Transition + assign in one call
echo '[
{"command":"workflow transition","args":{"issue":"PROJ-123","to":"Done"}},
{"command":"workflow assign","args":{"issue":"PROJ-123","to":"me"}}
]' | jr batch
Also available via
- Homebrew:
brew install sofq/tap/jr - npm:
npm install -g jira-jr - Scoop:
scoop bucket add sofq https://github.com/sofq/scoop-bucket && scoop install jr - Docker:
docker run --rm ghcr.io/sofq/jr version - Go:
go install github.com/sofq/jira-cli@latest
Documentation
Full docs, Claude Code skill, and source at github.com/sofq/jira-cli.
1 maintainer
Metadata
1 maintainer
Release files for jira-jr 1.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jira_jr-1.1.6.tar.gz | 3.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jira_jr-1.1.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.1 kB
Release files / jira_jr-1.1.6.tar.gz
| Download URL | jira_jr-1.1.6.tar.gz |
|---|---|
| Size | 3.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
51a2855db5b9d1ce26d56fee0eb590fbb37529e4e7e8a56f9d61762b3363c507
|
|
BLAKE2b-256 checksum How to use checksums |
883f18032b810147d90fca30bac58cc22e3589d00b59f42a4c96943d99608d18
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 21, 2026.
Transparency logRelease files / jira_jr-1.1.6-py3-none-any.whl
| Download URL | jira_jr-1.1.6-py3-none-any.whl |
|---|---|
| Size | 3.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4d29d94763c249ed60291da1d9d78bed52af96575aad81b840dcc99845682eeb
|
|
BLAKE2b-256 checksum How to use checksums |
38e1b2e39d3c588e4128d8be9b9cf3b02e08908171aa185a6b724504af3ab970
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 21, 2026.
Transparency log
