Engineering
jira-cli avatar

jira-cli

Interactive terminal interface for Atlassian Jira that streamlines issue management, sprint tracking, and ticket workflows directly from the command line.

Introduction

Jira CLI is a powerful, interactive command-line utility designed to replace the often cumbersome Jira web interface for developers, project managers, and technical team members. By providing a terminal user interface (TUI), it enables users to perform everyday Jira tasks—such as viewing issues, creating tickets, transitioning statuses, and managing sprints—without leaving the coding environment. This tool significantly reduces context switching and boosts productivity by allowing users to stay within their terminal flow for agile project management and issue tracking.

The skill supports both Jira Cloud and Jira Server (on-premise) environments and requires minimal configuration to start. It acts as a direct interface to the Jira API, handling authentication, project filtering, and ticket manipulation through intuitive commands. It is particularly valuable for developers who need to quickly check assigned issues, log updates, or push tickets through a workflow pipeline while working in a repository or terminal session.

  • Perform comprehensive issue management including listing, filtering, and detailed viewing of Jira tickets.

  • Execute rapid issue creation, cloning, and editing using command-line arguments or interactive prompts.

  • Manage agile ceremonies such as sprint navigation and epic association directly from the terminal.

  • Transition issue states (e.g., In Progress, Done) with support for comments and resolution details.

  • Utilize powerful filtering options with JQL, status, priority, reporter, and assignee parameters.

  • Output data in multiple formats including plain text, raw JSON, and CSV for easy integration with external shell scripts or data piping.

  • Handle authentication seamlessly via API tokens, PATs, or mTLS for secure connections to both cloud and enterprise installations.

  • Ensure the environment variable JIRA_API_TOKEN is properly set before initializing the tool with the jira init command.

  • Ideal for use within IDEs, terminal sessions, and automated CI/CD pipeline verification scripts.

  • Not recommended for bulk data migrations or Jira administrative tasks like user management and permission scheme configuration, which require the official Jira admin UI.

  • Configuration is managed via a .config.yml file, allowing for easy management of multiple Jira projects in different directory contexts.

  • Leverage shell completion support (Bash/Zsh) to speed up navigation through complex commands and issue IDs.

Repository Stats

Stars
0
Forks
0
Open Issues
0
Language
Shell
Default Branch
main
Sync Status
Idle
Last Synced
May 4, 2026, 01:25 AM
View on GitHub