An open API service indexing awesome lists of open source software.

https://github.com/aarondpn/redmine-cli

A powerful command-line interface for Redmine, enhanced with first-class AI agent capabilities via Skills and MCP integration.
https://github.com/aarondpn/redmine-cli

cli mcp mcp-server redmine redmine-api redmine-client skills

Last synced: about 2 months ago
JSON representation

A powerful command-line interface for Redmine, enhanced with first-class AI agent capabilities via Skills and MCP integration.

Awesome Lists containing this project

README

          


redmine-cli logo

redmine-cli


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


English ·
简体中文 ·
日本語


CI
Release
Go
License


Redmine 4.x
Redmine 5.x
Redmine 6.x


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

## インストール

### 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` にインストールします。

### 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 チェックサムで検証した後、バイナリを置き換えます。

## はじめに

```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`(ホスト設定に追加) |
| **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://aarondpn.github.io/redmine-cli/guides/ai-agents/) を参照してください。

## 開発

実際の Redmine インスタンスに対するローカル E2E テスト(Docker、Redmine `4.2`、`5.1`、`6.1` をサポート):[e2e/README.md](e2e/README.md) を参照してください。