187 online 3 members  + Join RP Base  +
FreeTool

redmine-cli

by onozaty  ·  version 1.2.0  ·  updated 17 hours ago

No reviews yet

Downloads
0
Reviews
0
Size
54 KB
Code check
Clean
Licence
MIT
Released
Nov 2026

A gh-style CLI for Redmine — manage issues, projects, and attachments from your terminal

redmine-cli
English | 日本語
redmine-cli
A CLI tool for working with Redmine from the terminal, with the feel of the GitHub CLI (gh).

$ redmine issue list --project website
ID  PROJECT  TRACKER  STATUS       PRIORITY  ASSIGNEE    SUBJECT
12  Website  Bug      In Progress  High      John Smith  Login fails when SSO is enabled
11  Website  Feature  New          Normal    Jane Doe    Add dark mode support
9   Website  Bug      New          Normal                Broken link on the pricing page

Showing 3 of 3 issues

InstallationHomebrew (macOS/Linux)
brew install onozaty/tap/redmine-cli

Scoop (Windows)
scoop bucket add onozaty https://github.com/onozaty/scoop-bucket
scoop install redmine-cli

Binary Download
Download the latest binary from GitHub Releases.
Quick start
**1. Log in (prompts for your Redmine URL and API key)**
redmine auth login
**2. List issues assigned to you**
redmine issue list --assignee me
**3. View one in detail**
redmine issue view 12 --comments

You can get your API key from your Redmine account page ("My account" → "API access key"; an administrator must enable the REST API first). The configuration is stored at ~/.config/redmine-cli/config.yml.
Commands
Command, Description

redmine auth login, Log in to a Redmine server
redmine auth status, View authentication status
redmine auth logout, Log out (remove the saved config)
redmine issue list, List issues
redmine issue view , View an issue
redmine issue create, Create a new issue
redmine issue edit , Edit an issue
redmine issue comment , Add a comment to an issue
redmine attachment download , Download an attachment
redmine project list, List projects
redmine project view , View a project
redmine status list, List issue statuses
redmine tracker list, List trackers
redmine priority list, List priorities

Run any command with --help to see all of its flags. All issue, project, status, tracker, and priority commands accept --json to print raw JSON instead of formatted text.
UsageAuthentication
redmine auth status    # Check the current login status
redmine auth logout    # Log out (remove the saved config)
**Non-interactive login**
redmine auth login --url https://redmine.example.com --api-key YOUR_API_KEY

Alternatively, set the REDMINE_URL and REDMINE_API_KEY environment variables to authenticate without logging in (useful in CI). Environment variables take precedence over the saved config.
Issues
List and filter:

redmine issue list                                   # Open issues (default)
redmine issue list --project website --status all    # --status: open|closed|all|
redmine issue list --assignee me --limit 50

View details:

$ redmine issue view 12 --comments
**12 Login fails when SSO is enabled**
Project:  Website
Tracker:  Bug
Status:   In Progress
Priority: High
Author:   Jane Doe
Assignee: John Smith
Progress: 50%
Created:  2026-07-01T09:30:00Z
Updated:  2026-07-10T14:12:34Z

Logging in via SSO redirects to an error page.

--- Attachments ---
**456  sso-error.png  (34567 bytes)**
--- Comments ---

John Smith (2026-07-10T14:12:34Z)
Reproduced on staging. Working on a fix.

Create, edit, and comment:

redmine issue create --project website --title "Broken link on the pricing page" \
  --tracker Bug --priority High --assignee me --body "The footer link returns 404."

redmine issue edit 12 --status Closed --done-ratio 100   # Only the given fields are updated

redmine issue comment 12 --body "Fixed in the latest release" --attach fix.patch

  • --tracker, --status, --priority, and --assignee accept either an ID or a name (me also works for the assignee).
  • --attach attaches a file and can be repeated; it works with create, edit, and comment.
  • Not sure which names are valid on your server? List them with redmine status list, redmine tracker list, and redmine priority list.
Attachments
redmine attachment download 456              # Save to the attachment's original filename
redmine attachment download 456 -o out.png   # Save to a specific path

Attachment IDs are shown in the output of redmine issue view.
Projects
redmine project list --limit 100
redmine project view website

Statuses, trackers, and priorities
redmine status list      # Valid --status values for issue list/edit
redmine tracker list     # Valid --tracker values for issue create/edit
redmine priority list    # Valid --priority values for issue create/edit

Use with AI agents
This repository bundles an Agent Skill (skills/redmine/) that teaches AI coding agents how to use the redmine command.

Claude Code — install it as a plugin:

/plugin marketplace add onozaty/redmine-cli
/plugin install redmine@redmine-cli

Other tools supporting Agent Skills (Codex CLI, Gemini CLI, GitHub Copilot, etc.) — copy the skills/redmine/ directory into your tool's skills directory (for example, ~/.claude/skills/ for Claude Code).

In non-interactive environments, agents can authenticate via the REDMINE_URL and REDMINE_API_KEY environment variables instead of redmine auth login.
Development
go build ./...
go test ./...