JiraCLI：提升Jira工作效率的命令行神器
项目地址: https://gitcode.com/gh_mirrors/ji/jira-cli 痛点：为什么需要Jira命令行工具？
你是否也经历过这样的场景？
- 每天需要频繁在浏览器和终端之间切换，只为查看Jira工单状态
- 想要快速搜索特定条件的工单，却要在Jira界面中层层点击筛选
- 需要批量处理工单时，只能一个个手动操作，效率低下
- 想要在自动化脚本中集成Jira操作，但API调用复杂难用
JiraCLI正是为解决这些痛点而生！ 这是一个功能丰富的交互式Jira命令行工具，让你无需离开终端就能高效管理Jira工作流。
核心功能全景图
快速入门指南
安装部署
JiraCLI支持多种安装方式，满足不同环境需求：
| 安装方式 | 命令示例 | 适用场景 |
|---|---|---|
| 二进制包 | 从发布页面下载 | 生产环境部署 |
| Docker | docker run -it --rm ghcr.io/ankitpokhrel/jira-cli:latest | 快速体验测试 |
| Homebrew | brew install jira-cli | macOS用户 |
| 源码编译 | make deps install | 开发调试 |
配置认证
配置过程简单直观，支持多种认证方式：
# 1. 设置API Token（Cloud版本）
export JIRA_API_TOKEN="your_api_token"
# 2. 初始化配置
jira init
# 选择安装类型（Cloud/Local）
# 提供服务器地址、登录邮箱等信息
# 自动生成配置文件
支持三种认证类型：
- Basic认证：使用用户名密码（默认）
- Bearer认证：使用个人访问令牌(PAT)
- mTLS认证：使用客户端证书
核心功能深度解析
工单管理：终端中的Jira操作中心
智能工单列表与筛选
JiraCLI的列表功能支持丰富的筛选条件，让你精准定位所需工单：
# 基础查询示例
jira issue list # 查看最近工单
jira issue list --created week # 本周创建的工单
jira issue list -s"In Progress" -a$(jira me) # 我负责的进行中工单
# 高级筛选组合
jira issue list -yHigh -s"To Do" --created month -lbackend -a$(jira me)
# 含义：高优先级 + 待办状态 + 本月创建 + backend标签 + 分配给我
交互式界面操作
JiraCLI提供类Vim的键盘操作体验：
工单创建与编辑
支持Markdown格式和模板化创建：
# 交互式创建
jira issue create
# 命令行快速创建
jira issue create -tBug -s"紧急Bug修复" -yHigh -lurgent -b"## 问题描述\n- 现象: xxx\n- 影响: yyy\n- 解决方案: zzz"
# 使用模板文件
jira issue create --template ./bug_report.tmpl
# 编辑现有工单
jira issue edit ISSUE-123 -s"更新后的摘要" -yMedium --label -urgent --label normal
Epic管理：宏观任务掌控
# Epic列表查看
jira epic list
jira epic list --table # 表格视图
jira epic list KEY-1 # 查看特定Epic中的工单
# Epic创建与管理
jira epic create -n"用户认证系统" -s"统一用户认证方案" -yHigh
jira epic add EPIC-42 ISSUE-123 ISSUE-124 # 添加工单到Epic
jira epic remove ISSUE-125 # 从Epic移除工单
Sprint管理：迭代周期控制
# Sprint状态查看
jira sprint list
jira sprint list --current # 当前活跃Sprint
jira sprint list --prev # 上一个Sprint
jira sprint list --next # 下一个Sprint
# Sprint工单管理
jira sprint add SPRINT-123 ISSUE-456 ISSUE-789
jira sprint list SPRINT-123 -a$(jira me) -yHigh # 查看我负责的高优先级工单
高级应用场景
自动化脚本集成
JiraCLI的--plain标志使其完美适配自动化脚本：
#!/bin/bash
# 每日工单统计脚本
# 统计今日创建的工单数量
today_tickets=$(jira issue list --created today --plain --no-headers | wc -l)
# 统计当前Sprint的工单状态分布
sprint_stats=$(jira sprint list --current --plain --columns status --no-headers | sort | uniq -c)
# 生成每日报告
echo "=== 每日J工单报告 ==="
echo "今日新增工单: $today_tickets"
echo "当前Sprint状态分布:"
echo "$sprint_stats"
批量操作示例
# 批量关闭已完成工单
jira issue list -sDone --plain --columns key --no-headers | while read issue_key; do
jira issue move "$issue_key" "Closed"
done
# 批量添加评论
for issue in ISSUE-123 ISSUE-456 ISSUE-789; do
echo "自动添加部署备注" | jira issue comment add "$issue" --template -
done
技术架构特色
基于现代Go语言生态
JiraCLI构建于强大的Go语言技术栈：
多平台兼容性
| 平台 | Jira类型 | 支持状态 |
|---|---|---|
| Linux | Cloud/Server | ✅ 完全支持 |
| macOS | Cloud/Server | ✅ 完全支持 |
| Windows | Cloud/Server | ⚠️ 部分支持 |
| FreeBSD | Cloud/Server | ✅ 完全支持 |
最佳实践指南
配置优化建议
- Shell补全配置：
# Bash用户
source <(jira completion bash)
# Zsh用户
source <(jira completion zsh)
- 多项目配置管理：
# 使用环境变量切换配置
export JIRA_CONFIG_FILE=~/.config/jira/project_a.yml
# 或使用命令行参数
jira issue list -c ~/.config/jira/project_b.yml
- API Token安全存储：
# 使用系统密钥链存储
jira init # 会自动提示安全存储选项
# 或使用.netrc文件
machine your-jira-instance.com
login your-email@example.com
password your-api-token
工作效率提升技巧
- 常用命令别名：
# 在.bashrc或.zshrc中添加
alias jl="jira issue list"
alias jc="jira issue create"
alias jv="jira issue view"
alias jm="jira issue move"
- 模板化工作流： 创建常用的工单模板文件：
# bug_report.tmpl
## 问题描述
## 重现步骤
1.
2.
3.
## 预期行为
## 实际行为
## 环境信息
- OS:
- Browser:
- Version:
- 集成开发环境： 将JiraCLI与你的IDE或编辑器集成，实现无缝的工作流体验。
总结展望
JiraCLI不仅仅是一个命令行工具，更是现代开发工作流的重要组成部分。它通过：
- 终端原生体验：减少上下文切换，提升专注度
- 批量操作能力：大幅减少重复性手动操作
- 脚本集成支持：实现工作流自动化
- 交互式界面：提供直观的操作体验
- 多平台兼容：适应不同开发环境
无论你是开发工程师、项目经理还是质量保证专员，JiraCLI都能为你的Jira使用体验带来质的飞跃。告别繁琐的网页操作，拥抱高效的命令行工作流！
立即开始使用JiraCLI，让你的Jira工作效率提升到一个新的水平！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
