Changelog

All notable changes to jira-cli are documented in this file.

Format loosely follows Keep a Changelog. Versions follow Semantic Versioning.

[0.2.2] - 2026-04-18

dist/plugin/ — Claude Code plugin + Codex-compatible skill for jira-cli. Installable via /plugin marketplace add zhiyue/jira-cli && /plugin install jira-cli@jira-cli in Claude Code, or via $skill-installer <tree-url> / a symlink to ~/.agents/skills/ in Codex CLI. Skill auto-triggers on Jira-shaped conversations and preflights jira-cli --version with an install hint on miss.

jira-cli --version now prints target triple and the 12-char git commit used for the build, matching the style of tools like gitlab: jira-cli 0.2.2 (target=aarch64-apple-darwin, git=...). Helps triage bug reports by pinning the exact artifact a user is running. The JSON schema command and the User-Agent header still use the bare semver string.

Removed the {"warning": "TLS verification disabled; do not use in production"} line that was emitted to stderr whenever insecure = true was active. It was noisy for agent/pipe users and the user already opted in via flag/env/config.

default_project config option (also readable from JIRA_PROJECT env). When set, issue create no longer requires --project; the flag falls back to config / env and errors with a clear hint if neither is provided.

Initial release. Agent-first CLI for legacy Jira Server 8.13.5.

Core: ping, whoami, config show|init, schema, session new, raw
Issue: get, create, update, delete, assign, bulk-create, changelog, comment {list|add|update|delete}, transitions list, transition, link {list|add|delete}, attachment {list|upload|download|delete}, worklog {list|add|delete}, watchers {list|add|remove}
Search: search <JQL> with streaming pagination, --keys-only, --max
Field: list, resolve
Project: list, get, statuses, components
User: get, search
Agile: board {list|get|backlog}, sprint {list|get|create|update|delete|move|issues}, epic {get|issues|add-issues|remove-issues}, backlog move
Bulk: transition, comment (parallel fan-out)

Stable exit codes (0/2/3/4/5/6/7) + structured stderr JSON errors with hints
--fields dot-path projection + --jira-fields server-side field selection
[field_aliases] display-name → id for --set writes
[field_renames] customfield id → readable name on output
auto_rename_custom_fields opt-in automatic slug generation with collision detection
[jql_aliases] named JQL snippets (search @alias)
[defaults] per-command default jira-fields
jira-cli schema for CLI capability discovery

Pre-built binaries for 7 targets (Darwin x86/arm, Linux gnu/musl × x86/arm, Windows x86)
install.sh + install.ps1 POSIX/Windows installers
Homebrew formula at dist/homebrew/jira-cli.rb