CLI for Jira AI integrations powered by jira2py helpers
Project description
jira2cli
CLI adapter for Jira Cloud, powered by jira2py helpers.
jira2cli is currently intended for local and development use from this workspace. Do not assume a published uvx or PyPI install path yet.
Environment
jira2cli uses the same Jira credentials as jira2mcp:
| Variable | Description |
|---|---|
JIRA_URL |
Your Jira instance URL |
JIRA_USER |
Your Jira account email |
JIRA_API_TOKEN |
Your Jira API token |
Example:
export JIRA_URL="https://yourcompany.atlassian.net"
export JIRA_USER="you@company.com"
export JIRA_API_TOKEN="your-api-token"
Local usage
From the workspace root:
uv sync --all-packages --group dev
uv run --package jira2cli jira2cli --help
uv run --package jira2cli jira2cli read PROJ-123
uv run --package jira2cli jira2cli search 'project = PROJ ORDER BY updated DESC'
uv run --package jira2cli jira2cli fields --project-key PROJ
uv run --package jira2cli jira2cli worklog-report --start-date 2026-06-12 --end-date 2026-06-13 --jql 'issue = PROJ-123'
Worklog reports
Use jira2cli worklog-report to build a report for issues selected by JQL.
- Required options:
--start-date,--end-date, and--jql. - Optional options:
--account-id,--max-issues,--include-details,--json, and--raw. - Issue selection is JQL-only. For a single issue, use
--jql 'issue = PROJ-123'. - Dates are interpreted in UTC, and
--end-dateis inclusive. --account-idfilters returned worklogs client-side by authoraccountId.--max-issuesdefaults to100, must be at least1, and limits how many JQL-matched issues are scanned; the report notes truncation when more issues match.- Output rows use
displayNameas the friendly user name. - Results depend on the configured Jira account's issue/worklog visibility and permissions.
Workspace layout
packages/jira2mcp— MCP adapter published asjira2mcp.packages/jira2cli— CLI adapter package.
For MCP installs and Claude setup, use uvx jira2mcp and claude mcp add jira -- uvx jira2mcp as documented in the repository root README.
Maintainers
Do not assume uvx jira2cli or pip install jira2cli is available yet. Keep using local workspace commands until the release gates in the maintainer docs are completed.
Release sequencing, package tags, and Trusted Publishing boundaries:
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file jira2cli-0.1.3.tar.gz.
File metadata
- Download URL: jira2cli-0.1.3.tar.gz
- Upload date:
- Size: 9.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e51f8378c8bf3fba12e8411b233803c79efa782e3c986428d3646720398d9169
|
|
| MD5 |
fe668925db4f6ba96af0914ff888645e
|
|
| BLAKE2b-256 |
493a02c492c0a9af11fb8cf8973fc5c61251f3ca7b9e176aba511f136bfebb9b
|
Provenance
The following attestation bundles were made for jira2cli-0.1.3.tar.gz:
Publisher:
publish.yml on en-ver/jira2ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
jira2cli-0.1.3.tar.gz -
Subject digest:
e51f8378c8bf3fba12e8411b233803c79efa782e3c986428d3646720398d9169 - Sigstore transparency entry: 1968901224
- Sigstore integration time:
-
Permalink:
en-ver/jira2ai@1199d4c2f7c8a198c48387eb86572b6c16545bc3 -
Branch / Tag:
refs/tags/jira2cli-v0.1.3 - Owner: https://github.com/en-ver
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1199d4c2f7c8a198c48387eb86572b6c16545bc3 -
Trigger Event:
push
-
Statement type:
File details
Details for the file jira2cli-0.1.3-py3-none-any.whl.
File metadata
- Download URL: jira2cli-0.1.3-py3-none-any.whl
- Upload date:
- Size: 16.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e85f47aa6fc899ab1d7b267f343bf1f65ce69dea5ae58c17d27bc73b8a06943f
|
|
| MD5 |
f7ef7fb5da65f1e6be8dc493311f6fdc
|
|
| BLAKE2b-256 |
1d2555d3128b9ab4c1eaef4f788c1f890df4dabbd4f164863fd4356a6fe56817
|
Provenance
The following attestation bundles were made for jira2cli-0.1.3-py3-none-any.whl:
Publisher:
publish.yml on en-ver/jira2ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
jira2cli-0.1.3-py3-none-any.whl -
Subject digest:
e85f47aa6fc899ab1d7b267f343bf1f65ce69dea5ae58c17d27bc73b8a06943f - Sigstore transparency entry: 1968901355
- Sigstore integration time:
-
Permalink:
en-ver/jira2ai@1199d4c2f7c8a198c48387eb86572b6c16545bc3 -
Branch / Tag:
refs/tags/jira2cli-v0.1.3 - Owner: https://github.com/en-ver
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@1199d4c2f7c8a198c48387eb86572b6c16545bc3 -
Trigger Event:
push
-
Statement type:
