PHPackages                             jeffersongoncalves/jira-cli - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. jeffersongoncalves/jira-cli

ActiveProject[CLI & Console](/categories/cli)

jeffersongoncalves/jira-cli
===========================

A Jira Cloud CLI built with Laravel Zero.

v1.0.4(1w ago)46MITPHPPHP ^8.2CI passing

Since Feb 24Pushed 1w ago1 watchersCompare

[ Source](https://github.com/jeffersongoncalves/jira-cli)[ Packagist](https://packagist.org/packages/jeffersongoncalves/jira-cli)[ Docs](https://github.com/jeffersongoncalves/jira-cli)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-jira-cli/feed)WikiDiscussions main Synced today

READMEChangelog (5)Dependencies (17)Versions (8)Used By (0)

[![Jira CLI](https://raw.githubusercontent.com/jeffersongoncalves/jira-cli/main/art/jeffersongoncalves-jira-cli.png)](https://raw.githubusercontent.com/jeffersongoncalves/jira-cli/main/art/jeffersongoncalves-jira-cli.png)

Jira CLI
========

[](#jira-cli)

A modern Jira Cloud CLI built with [Laravel Zero](https://laravel-zero.com/).

 [![Tests](https://github.com/jeffersongoncalves/jira-cli/actions/workflows/run-tests.yml/badge.svg)](https://github.com/jeffersongoncalves/jira-cli/actions) [![Build](https://github.com/jeffersongoncalves/jira-cli/actions/workflows/build.yml/badge.svg)](https://github.com/jeffersongoncalves/jira-cli/actions) [![Total Downloads](https://camo.githubusercontent.com/a1723b83cfb61529c1c7954c5aadd7aaa25111801af5e2056aec936e110bcb08/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6566666572736f6e676f6e63616c7665732f6a6972612d636c69)](https://packagist.org/packages/jeffersongoncalves/jira-cli) [![License](https://camo.githubusercontent.com/26c9c1bfa10b08d16e762a4ad5ecf8a4328e6ddb1ab9fd42ead0ce8da53d377c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a6566666572736f6e676f6e63616c7665732f6a6972612d636c69)](https://github.com/jeffersongoncalves/jira-cli/blob/main/LICENSE) [![PHP 8.2+](https://camo.githubusercontent.com/8f0af9c5395ae4ef8ba7a7ad65fa61c44927ea9c3eb3be91a13c678254f29bd4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e322d383839324246)](https://camo.githubusercontent.com/8f0af9c5395ae4ef8ba7a7ad65fa61c44927ea9c3eb3be91a13c678254f29bd4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e322d383839324246)

Features
--------

[](#features)

- **Issues** - Create, list, view, edit, move, assign, delete, comment, worklog, link, clone, and watch issues
- **Epics** - List, create, and manage epic associations
- **Sprints** - List, add issues, and close sprints
- **Boards** - List boards with project filtering
- **Projects** - List accessible projects
- **Releases** - List project versions and releases
- **Authentication** - Secure credential storage with API tokens (Basic and Bearer)
- **Browse** - Open issues and projects in the browser from the terminal

Requirements
------------

[](#requirements)

- PHP 8.2+

Installation
------------

[](#installation)

```
composer global require jeffersongoncalves/jira-cli
```

Or clone and build locally:

```
git clone https://github.com/jeffersongoncalves/jira-cli.git
cd jira-cli
composer install
php jira app:build jira
```

Getting Started
---------------

[](#getting-started)

### 1. Create a Jira API Token

[](#1-create-a-jira-api-token)

1. Go to
2. Click **Create API token**
3. Give it a descriptive label (e.g. `jira-cli`)
4. Click **Create** and **copy it immediately** - it will only be shown once

The API token inherits all permissions from your Atlassian account. For OAuth 2.0 / Forge apps, the following granular scopes are required:

> **Note:** API tokens (Basic auth) inherit all permissions from the account - no scope configuration needed. Scopes below are only for OAuth 2.0 and Forge integrations.

**Jira Platform Scopes:**

ScopePermissionRequired for`read:issue:jira`ReadList, view, and clone issues`write:issue:jira`WriteCreate, edit, assign, and clone issues`delete:issue:jira`DeleteDelete issues`read:issue.transition:jira`ReadList available status transitions`read:comment:jira`ReadView issue comments`write:comment:jira`WriteAdd comments to issues`read:issue-worklog:jira`ReadList worklogs`write:issue-worklog:jira`WriteLog time on issues`read:issue-link:jira`ReadView linked issues`write:issue-link:jira`WriteLink issues together`delete:issue-link:jira`DeleteRemove issue links`read:issue-link-type:jira`ReadList link types`write:issue.watcher:jira`WriteWatch issues`read:project:jira`ReadList projects`read:project-version:jira`ReadList releases/versions`read:user:jira`ReadUser info and assignment**Jira Software (Agile) Scopes:**

ScopePermissionRequired for`read:board-scope:jira-software`ReadList boards`read:sprint:jira-software`ReadList sprints`write:sprint:jira-software`WriteAdd issues to sprint, close sprint`read:epic:jira-software`ReadList epics`write:epic:jira-software`WriteAdd/remove issues from epics### 2. Save your credentials

[](#2-save-your-credentials)

```
jira auth:save
```

You will be prompted for your Jira server URL, Atlassian account email, and API token.

### 3. Verify authentication

[](#3-verify-authentication)

```
jira auth:show
```

### 4. Start using commands

[](#4-start-using-commands)

```
jira issue:list --project=PROJ
jira issue:view PROJ-123
jira me
```

Commands
--------

[](#commands)

### Authentication

[](#authentication)

CommandDescription`auth:save`Save Jira credentials (server, email, API token)`auth:show`Display saved credentials### Issues

[](#issues)

CommandDescription`issue:list`List/search issues with JQL filters (`--project`, `--type`, `--status`, `--assignee`)`issue:view `View issue details (`--comments` to include comments)`issue:create`Create a new issue (interactive or via options)`issue:edit `Edit issue fields (`--summary`, `--priority`, `--assignee`)`issue:move `Transition issue status (`--status` or interactive)`issue:assign  [user]`Assign issue (`me` for yourself, empty to unassign)`issue:delete `Delete an issue (`--force` to skip confirmation)`issue:comment `Add a comment (`--body` or interactive)`issue:worklog `Log time (`--time=2h`) or list worklogs (`--list`)`issue:link  `Link two issues (`--type` or interactive)`issue:unlink `Remove an issue link`issue:clone `Duplicate an issue`issue:watch `Watch an issue### Epics

[](#epics)

CommandDescription`epic:list`List epics (`--project=KEY`)`epic:create`Create a new epic (interactive or via options)`epic:add  `Add issues to an epic`epic:remove `Remove issues from their epic### Sprints

[](#sprints)

CommandDescription`sprint:list`List sprints (`--board=ID`, `--state=active|closed|future`)`sprint:add  `Add issues to a sprint`sprint:close `Close/complete a sprint (`--force` to skip confirmation)### Boards, Projects & Releases

[](#boards-projects--releases)

CommandDescription`board:list`List boards (`--project` to filter)`project:list`List accessible projects`release:list`List project versions (`--project=KEY`)### Utilities

[](#utilities)

CommandDescription`me`Show current authenticated user`open [key]`Open issue or project in the browser`serverinfo`Show Jira server informationDevelopment
-----------

[](#development)

```
# Install dependencies
composer install

# Run tests
composer test

# Run tests only
composer test:unit

# Code formatting
./vendor/bin/pint

# Static analysis
composer test:types
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

License
-------

[](#license)

Jira CLI is open-source software licensed under the [MIT license](LICENSE).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance98

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 91.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~30 days

Total

5

Last Release

11d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves)

---

Top Contributors

[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (44 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")

---

Tags

atlassianclicommand-lineconsoledevtoolsjirajira-apijira-clijira-cloudlaravel-zeropharphpproductivitycliconsolelaravel-zerojiraatlassian

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jeffersongoncalves-jira-cli/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersongoncalves-jira-cli/health.svg)](https://phpackages.com/packages/jeffersongoncalves-jira-cli)
```

###  Alternatives

[nunomaduro/collision

Cli error handling for console/command-line PHP applications.

4.7k357.7M11.1k](/packages/nunomaduro-collision)[symfony/console

Eases the creation of beautiful and testable command line interfaces

9.8k1.1B14.0k](/packages/symfony-console)[nunomaduro/laravel-console-menu

Laravel Console Menu is an output method for your Laravel/Laravel Zero commands.

819430.4k54](/packages/nunomaduro-laravel-console-menu)[nunomaduro/laravel-console-task

Laravel Console Task is a output method for your Laravel/Laravel Zero commands.

2592.3M13](/packages/nunomaduro-laravel-console-task)[nunomaduro/laravel-console-summary

A Beautiful Laravel Console Summary for your Laravel/Laravel Zero commands.

672.3M4](/packages/nunomaduro-laravel-console-summary)[nunomaduro/laravel-console-dusk

Laravel Console Dusk allows the usage of Laravel Dusk in Laravel/Laravel Zero artisan commands.

16458.3k8](/packages/nunomaduro-laravel-console-dusk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)