Redmine

redmine-cli

Redmineのプロジェクト管理用コマンドラインインターフェースです。

English · 简体中文 · 日本語

インストール · はじめに · AI エージェント

インストール

Homebrew（macOS と Linux）

brew tap aarondpn/tap
brew install redmine

これにより、bash、zsh、fish 用のシェル補完もインストールされます。

クイックインストールスクリプト

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

OS とアーキテクチャを自動検出し、チェックサムを検証して最新リリースをダウンロードし、~/.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 provenance を 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 モードでは、stderr の最終行に {"error": {...}} 形式の単一行エンベロープとして出力され、stdout は空のまま、終了コードはゼロ以外になります。出力形式を参照してください。

AI エージェントでの使用

redmine-cli には、Agent Skill（35 以上のエージェントがサポートするオープンな SKILL.md 標準）と、組み込みの MCP サーバーが付属しています。どちらもベンダーに依存しません。使用するツールに合った 1 行のコマンドを選んでください。

ツール	1 行でのインストール
任意のエージェント（スキル）	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

このスキルは、CLI の一見わかりにくい部分（出力形式、名前解決、ページネーション、一般的なワークフロー）をエージェントに教えます。MCP サーバーは同じ操作を型付きのツール呼び出しとして公開します。デフォルトでは読み取り専用で、グループ単位・ツール単位で許可リストと拒否リストを設定できます。

完全な設定、ホストごとの設定例（Claude Desktop、Cursor、Zed、VS Code）、および書き込みツールの制御については、AI エージェント統合ガイドを参照してください。

開発

実際の Redmine インスタンスに対するローカル E2E テスト（Docker を使用。Redmine 4.2、5.1、6.1、7.0 をサポート）については、e2e/README.mdを参照してください。