redmine-cli

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

## インストール ### Homebrew（macOS および Linux） ```bash brew tap aarondpn/tap brew install redmine ``` bash、zsh、fish 用のシェル補完も同時にインストールされます。 ### クイックインストールスクリプト ```bash curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash ``` OS とアーキテクチャを自動検出し、チェックサム検証付きで最新リリースをダウンロードして `~/.local/bin` にインストールします。新しめの [GitHub CLI](https://cli.github.com) がインストール済みでログインしている場合は、`gh attestation verify` でリリースのビルド attestation も検証し、失敗した場合はインストールを中止します。そのような `gh` がない場合はチェックサム検証のみでインストールし、警告と、リリースを自分で検証するためのコマンドを表示します。特定のリリースをインストールするには `REDMINE_CLI_VERSION=` を設定します。v2.11.2 より前のリリースには attestation がないため、ログイン済みの `gh` がある環境でそれらを指定する場合は `REDMINE_CLI_SKIP_ATTESTATION=1` も必要です。詳細は[インストールのドキュメント](https://redmine-cli.dev/getting-started/installation/)を参照してください。 ### Go でインストール ```bash go install github.com/aarondpn/redmine-cli/v2/cmd/redmine@latest ``` ### 手動ダウンロードお使いのプラットフォーム向けの最新リリースを [GitHub Releases](https://github.com/aarondpn/redmine-cli/releases/latest) から取得してください： | プラットフォーム | アーキテクチャ | ダウンロード | |------------------|-----------------|--------------| | 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` | ### アップデート ```bash redmine update ``` 最新リリースをダウンロードし、SHA256 チェックサムと GitHub artifact attestation（このリポジトリのリリースワークフローによる SLSA provenance。Sigstore で検証）を確認してからバイナリを置き換えます。いずれかの検証に失敗するとアップデートは拒否されます。`--skip-attestation` を指定すると、警告を表示したうえでチェックサム検証のみで続行します。 ## はじめに ```bash # Redmine サーバーと API キーを設定 redmine auth login # issue を一覧表示 redmine issues list # 特定の issue を表示 redmine issues view 123 # 作業時間を記録 redmine time log ``` `redmine --help` を実行すると、利用可能なすべてのコマンドが表示されます。 ## AI エージェントとの併用 redmine-cli は [Agent Skill](https://agentskills.io)（35 以上のエージェントが対応するオープン規格 `SKILL.md`）と組み込み MCP サーバーを同梱しています。どちらもベンダー中立です。お使いのツールに合わせてワンライナーを選んでください： | ツール | ワンライナー | |---|---| | **任意のエージェント（skill）** | `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`（追加した marketplace から **Redmine** をインストール） | | **Gemini CLI** | `gemini extensions install https://github.com/aarondpn/redmine-cli` | skill は CLI の非自明な部分（出力形式、名前解決、ページネーション、一般的なワークフロー）をエージェントに教えます。MCP サーバーは同じ操作を型付きツールコールとして公開し、デフォルトは読み取り専用、グループ単位／ツール単位の allow / deny リストを備えます。詳細な設定、ホスト別スニペット（Claude Desktop、Cursor、Zed、VS Code）、書き込みツールのゲートについては [AI エージェント連携ガイド](https://redmine-cli.dev/guides/ai-agents/) を参照してください。 ## 開発実際の Redmine インスタンスに対するローカル E2E テスト（Docker、Redmine `4.2`、`5.1`、`6.1`、`7.0` をサポート）：[e2e/README.md](e2e/README.md) を参照してください。