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
English | 日本語
redmine-cli
A CLI tool for working with Redmine from the terminal, with the feel of the GitHub CLI (
InstallationHomebrew (macOS/Linux)
Scoop (Windows)
Binary Download
Download the latest binary from GitHub Releases.
Quick start
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
Commands
Command, Description
Run any command with
UsageAuthentication
Alternatively, set the
Issues
List and filter:
View details:
Create, edit, and comment:
Attachment IDs are shown in the output of
Projects
Statuses, trackers, and priorities
Use with AI agents
This repository bundles an Agent Skill (skills/redmine/) that teaches AI coding agents how to use the
Claude Code — install it as a plugin:
Other tools supporting Agent Skills (Codex CLI, Gemini CLI, GitHub Copilot, etc.) — copy the
In non-interactive environments, agents can authenticate via the
Development
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 issuesInstallationHomebrew (macOS/Linux)
brew install onozaty/tap/redmine-cliScoop (Windows)
scoop bucket add onozaty https://github.com/onozaty/scoop-bucket
scoop install redmine-cliBinary 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 --commentsYou 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 serverredmine auth status, View authentication statusredmine auth logout, Log out (remove the saved config)redmine issue list, List issuesredmine issue view , View an issueredmine issue create, Create a new issueredmine issue edit , Edit an issueredmine issue comment , Add a comment to an issueredmine attachment download , Download an attachmentredmine project list, List projectsredmine project view , View a projectredmine status list, List issue statusesredmine tracker list, List trackersredmine priority list, List prioritiesRun 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_KEYAlternatively, 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 50View 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--assigneeaccept either an ID or a name (mealso works for the assignee).--attachattaches a file and can be repeated; it works withcreate,edit, andcomment.- Not sure which names are valid on your server? List them with
redmine status list,redmine tracker list, andredmine priority list.
redmine attachment download 456 # Save to the attachment's original filename
redmine attachment download 456 -o out.png # Save to a specific pathAttachment IDs are shown in the output of
redmine issue view.Projects
redmine project list --limit 100
redmine project view websiteStatuses, 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/editUse 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-cliOther 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 ./...