快速开始

初次设置

1. 运行登录向导并指向你的 Redmine 服务器：

   redmine auth login

2. 确认连接是否正常：

   redmine auth status

3. 开始管理工单、工时记录等内容。

工单

列表

redmine issues list --project myproject
redmine issues list --assignee me --status open

查看

redmine issues get 123

创建

redmine issues create \
  --project myproject \
  --subject "Fix login bug" \
  --tracker Bug

更新

redmine issues update 123 --status "In Progress" --assignee me

关闭

redmine issues close 123 --notes "Fixed in commit abc123"

浏览

redmine issues browse --project myproject

工时记录

# interactive
redmine time log

# one-shot
redmine time log --issue 123 --hours 2.5 --activity Development --comment "Code review"

# today's entries
redmine time list --user me --from today

搜索

redmine search "login bug"
redmine search issues "login bug" --project myproject
redmine search "login bug" --open-issues

名称解析

无需 ID

你无需记忆数字 ID。CLI 可通过名称解析跟踪类型、状态、优先级、项目和用户。

redmine issues create \
  --project myproject \
  --tracker Bug \
  --priority High \
  --assignee "John Smith"

redmine issues list --assignee me

`me` 关键字

me 始终解析为当前活跃配置文件的用户——在跨账户脚本中非常实用。

输出格式

redmine issues list          # table (default)
redmine issues list -o json  # machine-readable / scripting
redmine issues list -o csv   # spreadsheets

下一步

工单命令参考 工单各子命令的所有标志说明。

工时记录命令参考 工时记录功能的完整参考。

输出格式 使用 JSON 和 CSV 进行脚本编写的技巧。

AI 代理集成 将 CLI 集成到 Claude Code、Cursor 等工具中。