rmn

rmnRedmine CLI Tool

A fast, open-source command-line client for Redmine written in Go. Manage issues from your terminal or let AI agents handle it via the built-in MCP server.

Get Started

View on GitHub

Full Issue Lifecycle

List, view, create, update, close, and delete Redmine issues from the command line.

MCP Server for AI Agents

Expose Redmine operations to AI assistants like Claude Code via the Model Context Protocol.

Multiple Output Formats

Human-readable table (default) and machine-readable JSON for scripting and automation.

Flexible Filtering

Filter by project, status, assignee, and tracker with sorting and pagination support.

GitLab CLI-Inspired Aliases

Familiar shorthand commands (ls, show, get, new, rm) for faster workflows.

Six Installation Methods

Homebrew, mise, Nix, Go install, pre-built binaries, and build from source.

Shell Completion

Auto-complete for Bash, Zsh, Fish, and PowerShell.

XDG-Compliant Config

Respects $XDG_CONFIG_HOME for config file placement.

Security Hardened

TLS 1.2+ enforcement, secure file permissions (0600), and API key protection on redirects.

100% Test Coverage

Enforced in CI with every pull request.

Cross-Platform

Pre-built binaries for Linux, macOS, and Windows on both amd64 and arm64.

WARNING

This project is experimental. The API and CLI interface are not yet stable and may introduce breaking changes without notice.

Quick Start

bash

# 1. Install
brew tap nbifrye/rmn https://github.com/nbifrye/rmn.git
brew install nbifrye/rmn/rmn

# 2. Authenticate
rmn auth login --url https://your-redmine.example.com --api-key YOUR_API_KEY

# 3. List your issues
rmn issue list -a me

# 4. View issue details
rmn issue view 42