包简介

A Jira Cloud CLI built with Laravel Zero.

README 文档

README

Jira CLI

A modern Jira Cloud CLI built with Laravel Zero.

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

PHP 8.2+

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

1. Create a Jira API Token

Go to https://id.atlassian.com/manage-profile/security/api-tokens
Click Create API token
Give it a descriptive label (e.g. jira-cli)
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:

Scope	Permission	Required for
`read:issue:jira`	Read	List, view, and clone issues
`write:issue:jira`	Write	Create, edit, assign, and clone issues
`delete:issue:jira`	Delete	Delete issues
`read:issue.transition:jira`	Read	List available status transitions
`read:comment:jira`	Read	View issue comments
`write:comment:jira`	Write	Add comments to issues
`read:issue-worklog:jira`	Read	List worklogs
`write:issue-worklog:jira`	Write	Log time on issues
`read:issue-link:jira`	Read	View linked issues
`write:issue-link:jira`	Write	Link issues together
`delete:issue-link:jira`	Delete	Remove issue links
`read:issue-link-type:jira`	Read	List link types
`write:issue.watcher:jira`	Write	Watch issues
`read:project:jira`	Read	List projects
`read:project-version:jira`	Read	List releases/versions
`read:user:jira`	Read	User info and assignment

Jira Software (Agile) Scopes:

Scope	Permission	Required for
`read:board-scope:jira-software`	Read	List boards
`read:sprint:jira-software`	Read	List sprints
`write:sprint:jira-software`	Write	Add issues to sprint, close sprint
`read:epic:jira-software`	Read	List epics
`write:epic:jira-software`	Write	Add/remove issues from epics

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

jira auth:show

4. Start using commands

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

Commands

Authentication

Command	Description
`auth:save`	Save Jira credentials (server, email, API token)
`auth:show`	Display saved credentials

Issues

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

Epics

Command	Description
`epic:list`	List epics (`--project=KEY`)
`epic:create`	Create a new epic (interactive or via options)
`epic:add <epic> <issues...>`	Add issues to an epic
`epic:remove <issues...>`	Remove issues from their epic

Sprints

Command	Description
`sprint:list`	List sprints (`--board=ID`, `--state=active\|closed\|future`)
`sprint:add <sprint> <issues...>`	Add issues to a sprint
`sprint:close <sprint>`	Close/complete a sprint (`--force` to skip confirmation)

Boards, Projects & Releases

Command	Description
`board:list`	List boards (`--project` to filter)
`project:list`	List accessible projects
`release:list`	List project versions (`--project=KEY`)

Utilities

Command	Description
`me`	Show current authenticated user
`open [key]`	Open issue or project in the browser
`serverinfo`	Show Jira server information

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

Please see CHANGELOG for more information on what has changed recently.

License

Jira CLI is open-source software licensed under the MIT license.

jeffersongoncalves/jira-cli 适用场景与选型建议

jeffersongoncalves/jira-cli 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 6 次下载、GitHub Stars 达 3，最近一次更新时间为 2026 年 02 月 24 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「cli」「console」「jira」「atlassian」「laravel-zero」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 jeffersongoncalves/jira-cli 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 jeffersongoncalves/jira-cli 我们能提供哪些服务？

定制开发 / 二次开发

基于 jeffersongoncalves/jira-cli 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 jeffersongoncalves/jira-cli 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

elkuku/console-progressbar 4

This class provides you with an easy-to-use interface to progress bars.

rastor/jira-client 20

A simple PHP JIRA REST client

schulzefelix/laravel-search-console 50

A Laravel package to retrieve data from Google Search Console

novius/laravel-artisan-commands 7

Additional artisan commands for Laravel

dereuromark/jira-api-restclient 0

Jira REST API Client

rjvandoesburg/laravel-jira-webhook 4

An endpoint for your Laravel application to listen to Atlassian's Jira webhook events

jeffersongoncalves/jira-cli

包简介

关键字：