jpskill.com
🛠️ 開発・MCP コミュニティ

redmine-cli

Redmineのプロジェクト管理タスク全般を、コマンドラインツールを通じて実行できるようにし、課題の作成・検索・更新、時間の記録、プロジェクト情報の照会などをRedmineの操作に関連するキーワードから判断して支援するSkill。

📜 元の英語説明(参考)

Use the `redmine` CLI to interact with Redmine. Activate when the user asks to create, list, update, close, or search issues, log or view time entries, manage versions or memberships, query projects/users/groups, or perform any Redmine project management task. Also activate when the user says "redmine", "issue", "ticket", "time entry", or references Redmine workflows.

🇯🇵 日本人クリエイター向け解説

一言でいうと

Redmineのプロジェクト管理タスク全般を、コマンドラインツールを通じて実行できるようにし、課題の作成・検索・更新、時間の記録、プロジェクト情報の照会などをRedmineの操作に関連するキーワードから判断して支援するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o redmine-cli.zip https://jpskill.com/download/8667.zip && unzip -o redmine-cli.zip && rm redmine-cli.zip
🪟 Windows (PowerShell)
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/8667.zip -OutFile "$d\redmine-cli.zip"; Expand-Archive "$d\redmine-cli.zip" -DestinationPath $d -Force; ri "$d\redmine-cli.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して redmine-cli.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → redmine-cli フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Redmine CLI

Redmine REST API 用の CLI です。詳細なフラグと例については redmine <command> --help を使用してください。このスキルでは、--help では説明されない内容のみを扱います。

利用可能なコマンド

以下のトップレベルのコマンドのみが存在します。ここにリストされていないサブコマンドを勝手に作成しないでください。サブコマンドを見つけるには redmine <command> --help を実行してください。

コマンド 目的
issues issue の作成、リスト表示、取得、更新、クローズ、再オープン、担当者割り当て、コメント、削除、検索、ブラウズ
projects プロジェクトのリスト表示、取得、作成、更新、削除。プロジェクトメンバーのリスト表示
time 作業時間の記録、リスト表示、取得、更新、削除、集計
versions プロジェクトのバージョン(マイルストーン)のリスト表示、取得
memberships プロジェクトメンバーシップのリスト表示、取得、作成、更新、削除
users ユーザーのリスト表示、取得、作成、更新、削除
groups グループのリスト表示、取得、作成、更新、削除。ユーザーの追加/削除
categories issue カテゴリのリスト表示
trackers トラッカーのリスト表示
statuses issue ステータスのリスト表示
search issue、wiki、ニュース、メッセージの検索、または結果のブラウズ
api 認証された生の API リクエストの実行

セットアップ

redmine コマンドが見つからない場合は、インストールしてください。

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

次に、インタラクティブな設定のために redmine init を実行します。既存の設定を確認するには redmine config を使用します。

重要なルール

  • 出力をプログラムで解析する必要がある場合は、常に -o json を使用してください。JSON は stdout のみに出力され、stderr は分離されています。
  • すべての結果を取得するには --limit 0 を使用してください。デフォルトの制限は 100 です。
  • すべての名前を受け入れるフラグ(--project、--tracker、--status、--priority、--assignee、--category、--version、--activity)は、人間が読める名前を自動的に解決します。最初に ID を調べる必要はありません。
  • --assignee me は、現在の API ユーザーを指します。
  • *`--status ""** は、ステータスに関係なくすべての issue を表示します(デフォルトはopen` です)。

権限の注意点: ユーザーとグループ

名前でユーザーとグループを解決するには、管理者権限が必要です。権限エラーが発生した場合:

  • 同じ名前で再試行しないでください
  • 現在のユーザーには me を使用してください
  • 管理者アクセスなしでユーザー ID を見つけるには、他のソースから抽出します。
    • redmine issues list --project <project> -o jsonassigned_to および author フィールドには、ユーザー ID と名前が含まれています
    • redmine memberships list --project <project> -o json — すべてのプロジェクトメンバーを ID とともにリスト表示します
    • redmine issues get <id> --journals -o json — ジャーナルエントリにはユーザー参照が含まれています

ワークフロー: あいまいな値の解決

コマンドが固定セット(tracker、status、priority、category、version、assignee)から値を取得する必要があり、正確な名前がわからない場合:

  1. 最初にオプションをクエリします: redmine trackers list -o jsonredmine statuses list -o json など。
  2. フォーマットされたリストを使用して、ユーザーに選択肢を提示します(AskUserQuestion を使用)
  3. 確認された値を コマンドで使用します

ユーザー/グループの場合、リストエンドポイントが権限エラーで失敗する場合は、代わりに上記のセクションの回避策を使用してください。

自明ではない動作

  • redmine issues list は、デフォルトで --status open になります。--status closed--status "*"、または特定のステータス名を使用してください。
  • redmine issues get <id> --journals には、コメント/履歴が含まれます。--children--relations も利用可能です。
  • redmine issues update は、明示的に渡したフラグのみを送信します。省略されたフラグは変更されません。
  • --project が省略された場合、設定されたデフォルトプロジェクトが使用されます(redmine init で設定)。
  • redmine versions list のバージョンステータスフィルター(--open--closed--locked)は、クライアント側で適用されます。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Redmine CLI

A CLI for the Redmine REST API. Use redmine <command> --help for detailed flags and examples — this skill only covers what --help cannot tell you.

Available Commands

Only these top-level commands exist. Do NOT invent subcommands that aren't listed here — run redmine <command> --help to discover subcommands.

Command Purpose
issues Create, list, get, update, close, reopen, assign, comment, delete, search, browse issues
projects List, get, create, update, delete projects; list project members
time Log, list, get, update, delete, summarize time entries
versions List, get project versions (milestones)
memberships List, get, create, update, delete project memberships
users List, get, create, update, delete users
groups List, get, create, update, delete groups; add/remove users
categories List issue categories
trackers List trackers
statuses List issue statuses
search Search issues, wiki, news, messages, or browse results
api Make raw authenticated API requests

Setup

If the redmine command is not found, install it:

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

Then run redmine init for interactive configuration. Use redmine config to verify an existing setup.

Critical Rules

  • Always use -o json when you need to parse output programmatically. JSON goes to stdout only; stderr is separate.
  • Use --limit 0 to fetch ALL results. The default limit is 100.
  • All name-accepting flags (--project, --tracker, --status, --priority, --assignee, --category, --version, --activity) resolve human-readable names automatically. You don't need to look up IDs first.
  • --assignee me refers to the current API user.
  • *`--status ""** shows all issues regardless of status (default isopen`).

Permission Gotcha: Users & Groups

Resolving users and groups by name requires admin privileges. If you get a permission error:

  • Do NOT retry with the same name
  • Use me for the current user
  • To discover user IDs without admin access, extract them from other sources:
    • redmine issues list --project <project> -o json — the assigned_to and author fields contain user IDs and names
    • redmine memberships list --project <project> -o json — lists all project members with their IDs
    • redmine issues get <id> --journals -o json — journal entries contain user references

Workflow: Resolving Ambiguous Values

When a command needs a value from a fixed set (tracker, status, priority, category, version, assignee) and you're not sure of the exact name:

  1. Query options first: redmine trackers list -o json, redmine statuses list -o json, etc.
  2. Present choices to the user via AskUserQuestion with a formatted list
  3. Use the confirmed value in the command

For users/groups, if the list endpoint fails with a permission error, use the workarounds from the section above instead.

Non-Obvious Behaviors

  • redmine issues list defaults to --status open. Use --status closed, --status "*", or a specific status name.
  • redmine issues get <id> --journals includes comments/history. Also available: --children, --relations.
  • redmine issues update only sends flags you explicitly pass — omitted flags are not changed.
  • If --project is omitted, the configured default project is used (set via redmine init).
  • Version status filters (--open, --closed, --locked) on redmine versions list are applied client-side.