redmine-cli

Redmine REST API を操作する Go 製 CLI ツール。

インストール

Homebrew (macOS)

brew install chippy-ao/tap/redmine-cli

mise (macOS/Linux)

mise use -g chippy-ao/redmine-cli

go install

go install github.com/chippy-ao/redmine-cli@latest

GitHub Releases

https://github.com/chippy-ao/redmine-cli/releases から各OS向けバイナリをダウンロード。

セットアップ

# プロファイルを追加
redmine-cli config add work --url https://redmine.example.com --api-key YOUR_API_KEY

# デフォルトプロファイルを設定（最初に追加したものが自動でデフォルトになる）
redmine-cli config set-default work

# プロファイル一覧
redmine-cli config list

使い方

チケット検索

redmine-cli search --keyword "バグ" --status open
redmine-cli search --project myproject --assigned-to me
redmine-cli search --keyword "ログイン" --tracker-id 1 --limit 10

チケット詳細

redmine-cli get-issue 1234
redmine-cli get-issue 1234 --include journals,children

チケット作成

redmine-cli create-issue --project myproject --subject "バグ修正"
redmine-cli create-issue --project myproject --subject "新機能" --tracker-id 2 --priority-id 1 --description "詳細説明"
redmine-cli create-issue --project myproject --subject "子タスク" --parent-issue-id 1234

リレーション操作

# リレーション作成
redmine-cli add-relation --issue-id 1234 --related-id 5678 --type relates
redmine-cli add-relation --issue-id 1234 --related-id 5678 --type precedes --delay 3

# リレーション削除
redmine-cli delete-relation 443

一覧取得

redmine-cli projects
redmine-cli trackers
redmine-cli statuses
redmine-cli priorities
redmine-cli categories --project myproject
redmine-cli versions --project myproject
redmine-cli members --project myproject

複数環境の切り替え

redmine-cli --profile work search --keyword "タスク"
redmine-cli --profile oss search --keyword "issue"

出力

すべてのコマンドは JSON を stdout に出力します。エラーは stderr に出力されます。

前提条件

• Redmine 5.1.0+（keyword 検索に any_searchable フィルタを使用）

ライセンス

MIT