redmine-cli
GitHub通过CLI与Redmine交互，支持创建、查询和管理Issue、项目、时间记录等。自动解析名称，需以JSON格式输出以便程序处理。遇到权限问题时提供替代方案获取ID。
Trigger Scenarios
Install
npx skills add NeverSight/learn-skills.dev --skill redmine-cli -g -y
SKILL.md
Frontmatter
{
"name": "redmine-cli",
"description": "Use the `redmine` CLI to interact with Redmine. Activate when the user asks to create, list, update, close, or search issues, log or view time entries, manage versions or memberships, query projects\/users\/groups, or perform any Redmine project management task. Also activate when the user says \"redmine\", \"issue\", \"ticket\", \"time entry\", or references Redmine workflows."
}
Redmine CLI
A CLI for the Redmine REST API. Use redmine <command> --help for detailed flags and examples — this skill only covers what --help cannot tell you.
Available Commands
Only these top-level commands exist. Do NOT invent subcommands that aren't listed here — run redmine <command> --help to discover subcommands.
| Command | Purpose |
|---|---|
issues |
Create, list, get, update, close, reopen, assign, comment, delete, search, browse issues |
projects |
List, get, create, update, delete projects; list project members |
time |
Log, list, get, update, delete, summarize time entries |
versions |
List, get project versions (milestones) |
memberships |
List, get, create, update, delete project memberships |
users |
List, get, create, update, delete users |
groups |
List, get, create, update, delete groups; add/remove users |
categories |
List issue categories |
trackers |
List trackers |
statuses |
List issue statuses |
search |
Search issues, wiki, news, messages, or browse results |
api |
Make raw authenticated API requests |
Setup
If the redmine command is not found, install it:
curl -fsSL https://raw.githubusercontent.com/aarondpn/redmine-cli/main/install.sh | bash
Then run redmine init for interactive configuration. Use redmine config to verify an existing setup.
Critical Rules
- Always use
-o jsonwhen you need to parse output programmatically. JSON goes to stdout only; stderr is separate. - Use
--limit 0to fetch ALL results. The default limit is 100. - All name-accepting flags (--project, --tracker, --status, --priority, --assignee, --category, --version, --activity) resolve human-readable names automatically. You don't need to look up IDs first.
--assignee merefers to the current API user.--status "*"shows all issues regardless of status (default isopen).
Permission Gotcha: Users & Groups
Resolving users and groups by name requires admin privileges. If you get a permission error:
- Do NOT retry with the same name
- Use
mefor the current user - To discover user IDs without admin access, extract them from other sources:
redmine issues list --project <project> -o json— theassigned_toandauthorfields contain user IDs and namesredmine memberships list --project <project> -o json— lists all project members with their IDsredmine issues get <id> --journals -o json— journal entries contain user references
Workflow: Resolving Ambiguous Values
When a command needs a value from a fixed set (tracker, status, priority, category, version, assignee) and you're not sure of the exact name:
- Query options first:
redmine trackers list -o json,redmine statuses list -o json, etc. - Present choices to the user via AskUserQuestion with a formatted list
- Use the confirmed value in the command
For users/groups, if the list endpoint fails with a permission error, use the workarounds from the section above instead.
Non-Obvious Behaviors
redmine issues listdefaults to--status open. Use--status closed,--status "*", or a specific status name.redmine issues get <id> --journalsincludes comments/history. Also available:--children,--relations.redmine issues updateonly sends flags you explicitly pass — omitted flags are not changed.- If
--projectis omitted, the configured default project is used (set viaredmine init). - Version status filters (
--open,--closed,--locked) onredmine versions listare applied client-side.
Version History
- e0220ca Current 2026-07-05 22:09
