Redmine

redmine-cli

用于Redmine项目管理的命令行界面。

English · 简体中文 · 日本語

安装 · 快速入门 · AI Agent

安装

Homebrew（macOS 和 Linux）

brew tap aarondpn/tap
brew install redmine

此外还会安装 bash、zsh 和 fish 的 shell 补全功能。

快速安装脚本

curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash

自动检测操作系统和架构，下载最新版本并验证校验和，然后安装到 ~/.local/bin。如果已安装并登录较新的 GitHub CLI，脚本还会使用 gh attestation verify 验证版本的构建证明；若验证失败，则拒绝安装。如果没有这样的 gh，脚本只会在校验和检查后安装，并打印一条警告，附上供你自行验证版本的命令。设置 REDMINE_CLI_VERSION=<tag> 可安装指定版本；早于 v2.11.2 的版本没有证明，因此使用已登录的 gh 固定安装这类版本时，还需要设置 REDMINE_CLI_SKIP_ATTESTATION=1。详情请参阅安装文档。

使用 Go 安装

go install github.com/aarondpn/redmine-cli/v2/cmd/redmine@latest

手动下载

从 GitHub Releases 下载适用于你平台的最新版本：

平台	架构	下载
Linux	x86_64	redmine-cli-linux-amd64.tar.gz
Linux	ARM64	redmine-cli-linux-arm64.tar.gz
macOS	Intel	redmine-cli-darwin-amd64.tar.gz
macOS	Apple Silicon	redmine-cli-darwin-arm64.tar.gz
Windows	x86_64	redmine-cli-windows-amd64.zip

更新

redmine update

下载最新版本，并在替换二进制文件前验证其 SHA256 校验和以及 GitHub 工件证明（来自此仓库发布工作流的 SLSA 来源证明，通过 Sigstore 验证）。任一检查失败都会拒绝更新；--skip-attestation 会在警告后退回到仅验证校验和。

开始使用

# Configure your Redmine server and API key
redmine auth login

# List issues
redmine issues list

# View a specific issue
redmine issues view 123

# Log time
redmine time log

# Script it: JSON output filtered with the built-in --jq
redmine issues list --project myproject --jq '.[].id'
redmine issues get 123 --jq '.status.name'

运行 redmine --help 查看所有可用命令。

-o json 会输出机器可读的 JSON，-q/--jq <expression> 可对其进行筛选（字符串会直接输出，其他内容均以 JSON 格式输出）。错误始终输出到 stderr；在 JSON 模式下，错误会以单行 {"error": {...}} 封装的形式显示在 stderr 的最后一行，stdout 保持为空，退出码为非零。请参阅输出格式。

与 AI Agent 配合使用

redmine-cli 提供 Agent Skill（开放的 SKILL.md 标准，受 35+ 个 Agent 支持）和内置 MCP 服务。二者均不绑定特定厂商——选择与你的工具匹配的一行命令：

工具	一行安装命令
任意 Agent（技能）	npx skills add aarondpn/redmine-cli
任意 MCP 主机	redmine mcp serve（然后添加到主机配置中）
Docker（仅 MCP）	docker run -i --rm -e REDMINE_SERVER -e REDMINE_API_KEY ghcr.io/aarondpn/redmine-mcp
Claude Code	/plugin marketplace add aarondpn/redmine-cli，然后运行 /plugin install redmine
Codex CLI	codex plugin marketplace add aarondpn/redmine-cli，然后运行 /plugins（从已添加的市场安装 Redmine）
Gemini CLI	gemini extensions install https://github.com/aarondpn/redmine-cli

该技能会教 Agent 掌握 CLI 中不明显的部分（输出格式、名称解析、分页和常见工作流）。MCP 服务将相同操作作为类型化工具调用提供，默认只读，并支持按组和按工具设置允许列表与拒绝列表。

完整配置、针对不同主机的配置片段（Claude Desktop、Cursor、Zed、VS Code）以及写入工具的启用控制，请参阅 AI Agent 集成指南。

开发

如需使用 Docker 在真实 Redmine 实例上进行本地端到端测试（支持 Redmine 4.2、5.1、6.1、7.0），请参阅 e2e/README.md。