Skip to content

使い方

チケット

チケットの一覧表示

bash
rmn issue list                                    # オープンなチケットを一覧表示(デフォルト上限: 25)
rmn issue list -p my-project                      # プロジェクトでフィルタ
rmn issue list -s closed                          # ステータスでフィルタ(open, closed, *, またはステータスID)
rmn issue list -a me                              # 自分に割り当てられたチケット
rmn issue list -t 2                               # トラッカーIDでフィルタ
rmn issue list --sort updated_on:desc             # カラムでソート
rmn issue list -l 50 --offset 100                 # ページネーション
rmn issue list -p my-project -s closed -a me      # フィルタを組み合わせ

チケットの閲覧

bash
rmn issue view 42                                 # チケットの詳細を表示

チケットの作成

bash
rmn issue create -p my-project -s "Bug report"
rmn issue create -p my-project -s "Feature request" -d "Detailed description" \
  -t 2 --priority 3 -a 5 --start-date 2025-01-01 --due-date 2025-03-31

作成時の全フラグ: --project/-p(必須)、--subject/-s(必須)、--description/-d--tracker/-t--priority--assignee/-a--category--version--parent--start-date--due-date--estimated-hours--done-ratio

チケットの更新

bash
rmn issue update 42 --status 3                    # ステータスを変更
rmn issue update 42 -n "Work in progress"         # ノートを追加
rmn issue update 42 --done-ratio 50 --priority 2  # 複数フィールドを更新

指定されたフィールドのみ変更され、省略されたフィールドは変更されません。作成時の全フラグに加えて、--status--notes/-n が使用可能です。

チケットのクローズ

bash
rmn issue close 42                                # クローズ(デフォルトのステータスID 5)
rmn issue close 42 --status 6                     # カスタムステータスIDでクローズ
rmn issue close 42 -n "Fixed in v1.2"             # ノート付きでクローズ

チケットの削除

bash
rmn issue delete 42                               # 確認プロンプト付きで削除
rmn issue delete 42 -y                            # 確認をスキップ

プロジェクト

bash
rmn project list                                  # アクティブなプロジェクトを一覧表示
rmn project list --status archived                # ステータスでフィルタ
rmn project view my-project                       # 識別子または数値IDで参照
rmn project view my-project --include trackers,issue_categories
rmn project create --name "新プロジェクト" --identifier new-project -d "説明"
rmn project update my-project --name "改名"
rmn project archive my-project                    # 非表示化(復元可能)
rmn project unarchive my-project
rmn project delete my-project -y                  # 完全削除

ユーザー

bash
rmn user list                                     # アクティブなユーザーを一覧表示(管理者権限が必要)
rmn user list --status 1 --name ali
rmn user view 42                                  # 数値IDでユーザー参照
rmn user view me                                  # 現在のAPIキーに対応するユーザー

バージョン

bash
rmn version list -p my-project                    # プロジェクトのバージョン一覧
rmn version view 10
rmn version create -p my-project --name v1.0 --due-date 2026-06-01
rmn version update 10 --status locked
rmn version delete 10 -y

作業時間

bash
rmn time-entry list                               # 閲覧可能な作業時間を一覧表示
rmn time-entry list -p my-project --from 2026-01-01 --to 2026-03-31
rmn time-entry create --issue 42 --hours 1.5 -c "デバッグ"
rmn time-entry create -p my-project --hours 2 --activity 9
rmn time-entry update 5 --hours 2.5
rmn time-entry delete 5 -y

メンバーシップ

bash
rmn membership list -p my-project                 # プロジェクトメンバーを一覧表示
rmn membership view 3
rmn membership create -p my-project --user 5 --role 3 --role 4
rmn membership update 3 --role 4
rmn membership delete 3 -y

Wikiページ

bash
rmn wiki list -p my-project                       # Wikiページ一覧
rmn wiki view Home -p my-project                  # ページ内容を表示
rmn wiki view Home -p my-project --version 3      # 過去のバージョン
rmn wiki create Home -p my-project --text "h1. こんにちは"
rmn wiki update Home -p my-project --text "h1. 更新"
rmn wiki delete Home -p my-project -y

トラッカー・ステータス(参照データ)

bash
rmn tracker list                                  # トラッカー一覧(Bug、Featureなど)
rmn status list                                   # チケットステータス一覧

コマンドエイリアス

コマンドエイリアス
rmn issue listls
rmn issue viewshow, get
rmn issue createnew
rmn issue deleterm
bash
rmn issue ls                    # rmn issue list と同じ
rmn issue show 42               # rmn issue view 42 と同じ
rmn issue new -p proj -s "Bug"  # rmn issue create ... と同じ
rmn issue rm 42                 # rmn issue delete 42 と同じ

グローバルフラグ

フラグ説明
--output出力形式: table(デフォルト)または json
--redmine-urlRedmineインスタンスURLをオーバーライド
--api-keyRedmine APIキーをオーバーライド

JSON出力

--output json を任意のコマンドに指定すると、スクリプトやパイプに便利な機械可読出力が得られます:

bash
rmn issue list --output json                      # チケットのJSON配列
rmn issue view 42 --output json                   # チケット全体をJSONで表示
rmn issue list -p my-project --output json | jq '.issues[].subject'

MITライセンスの下で公開されています。