Issues

The issues command (alias i) manages Redmine issues end-to-end.

listFilter and page through issues.

getView a single issue with journals and relations.

createCreate an issue, optionally with attachments.

updateChange fields, add notes, attach files.

closeClose an issue with an optional comment.

reopenReopen a previously closed issue.

assignAssign an issue to a user.

commentAdd a comment without other changes.

watchersList, add, or remove watchers.

relationsLink or unlink issues to each other.

deletePermanently remove an issue.

openOpen the issue in your browser.

browseInteractive terminal browser.

list

redmine issues list [flags]

Flag	Description
--project	Filter by project (name, identifier, or ID)
--tracker	Filter by tracker (name or ID)
--status	Filter by status: open, closed, *, name, or ID
--assignee	Filter by assignee: me, name, login, or ID
--author	Filter by author: me, name, login, or ID
--priority	Filter by priority (name or ID)
--category	Filter by issue category (name or ID)
--version	Filter by target version (name or ID)
--parent	Restrict to children of a parent issue ID
--subproject	Subproject filter: numeric ID, or !* to exclude subprojects
--include-subprojects	Include issues from subprojects (default true; pair with =false to exclude)
--is-private	Filter by privacy: true returns private issues only, false public only
--filter	Raw Redmine filter as key=value (repeatable). Use for date ranges, custom fields, subject text
--query	Run a saved query by name (see queries)
--query-id	Run a saved query by numeric ID (mutually exclusive with --query)
--sort	Sort order, e.g. updated_on:desc
--include	Include related data: attachments, relations
--attachments	Shorthand for --include attachments
--relations	Shorthand for --include relations
--limit	Maximum number of results (0 for all)
--offset	Result offset for pagination
-o, --output	Output format: table, json, csv

Tip

--filter is an escape hatch for Redmine’s filter operator syntax. Examples:

• --filter created_on='>=2025-01-01' — created on or after a date
• --filter updated_on='><2025-01-01|2025-12-31' — updated in a range
• --filter cf_5='Critical' — custom field cf_5 equals “Critical”
• --filter subject='~login' — subject contains “login”

Mine

redmine issues list --assignee me

Project bugs

redmine issues list --project myproject --tracker Bug

Recently closed

redmine issues list --status closed --sort updated_on:desc

get

redmine issues get <id> [flags]

Aliases: show, view.

Flag	Description
--include	Include related data: journals, children, relations, attachments
--journals	Shorthand for --include journals
--children	Shorthand for --include children
--relations	Shorthand for --include relations
--attachments	List the issue’s attachments (id, filename, size, content type)
--download-attachments	Download every attachment of the issue into the given directory
-o, --output	Output format

Attachments

# List attachment IDs so you can download one
redmine issues get 123 --attachments

Download all

# Pull every attachment into ./issue-123
redmine issues get 123 --download-attachments ./issue-123

Tip

--attachments surfaces each attachment’s ID. Feed that ID to attachments download <id> to fetch a single file, or use --download-attachments <dir> to grab them all at once.

create

redmine issues create [flags]

Flag	Description
--project	Project (name, identifier, or ID) — falls back to the default project of the active profile
--subject	Issue subject — required
--tracker	Tracker (name or ID)
--status	Status (name or ID)
--priority	Priority (name or ID)
--assignee	Assignee: me, name, or ID
--description	Issue description
--parent	Parent issue ID
--category	Category (name or ID)
--version	Target version (name or ID)
--start-date	Start date (YYYY-MM-DD)
--due-date	Due date (YYYY-MM-DD)
--estimated-hours	Estimated hours
--private	Mark as private
--watcher	Initial watcher (name, login, ID, or me; repeatable)
--custom-field	Custom field value as name=value or id=value (repeatable)
--attach	File path to attach (repeatable)

redmine issues create --project myproject --subject "Add search" --tracker Feature --priority High

redmine issues create --project myproject --subject "Bug report" \
  --start-date 2026-05-01 --due-date 2026-05-15 \
  --watcher me --watcher "QA Bot" \
  --custom-field Severity=High \
  --attach /path/to/screenshot.png --attach /path/to/log.txt

update

redmine issues update <id> [flags]

Accepts the same flags as create (except --project and --watcher) plus:

Flag	Description
--note	Add a journal note
--private-notes	Mark the journal note from --note as private (requires --note)
--done-ratio	Completion percentage (0-100)
--start-date	Start date (empty string clears)
--due-date	Due date (empty string clears)
--custom-field	Custom field value as name=value or id=value (repeatable)
--attach	File path to attach (repeatable)

redmine issues update 123 --note "Fixed the bug" --attach /path/to/fixed_code.patch

# Private journal note visible only to staff
redmine issues update 123 --note "Internal context" --private-notes

# Update custom field by name
redmine issues update 123 --custom-field Severity=Critical

close

redmine issues close <id> [flags]

Flag	Description
--note	Add a closing comment

reopen

redmine issues reopen <id> [flags]

assign

redmine issues assign <id> <user-id-or-name> [flags]

The user argument accepts a numeric ID, login, full name, or me.

comment

redmine issues comment <id> --message "Your comment" [flags]

watchers

redmine issues watchers list <id>
redmine issues watchers add <id> <user>
redmine issues watchers remove <id> <user>

<user> accepts a numeric ID, login, full name, or me.

redmine issues watchers add 123 me
redmine issues watchers list 123
redmine issues watchers remove 123 alice

relations

redmine issues relations list <id>
redmine issues relations add <id> --to <other-id> --type <type> [--delay <days>]
redmine issues relations remove <relation-id>

Flag	Description
--to	Target issue ID — required
--type	Relation type. Default relates. See table below
--delay	Number of days delay. Only valid for precedes/follows

Supported relation types (from the Redmine REST docs):

Type	Meaning
relates	Generic association
duplicates	This issue duplicates the target
duplicated	This issue is duplicated by the target
blocks	This issue blocks the target
blocked	This issue is blocked by the target
precedes	This issue precedes the target (accepts --delay)
follows	This issue follows the target (accepts --delay)
copied_to	This issue was copied to the target
copied_from	This issue was copied from the target

redmine issues relations add 123 --to 124 --type blocks
redmine issues relations add 123 --to 124 --type precedes --delay 5
redmine issues relations list 123
redmine issues relations remove 42

Note

relations remove takes the relation ID, not an issue ID. Use relations list first to discover the relation IDs on an issue.

delete

destructive

redmine issues delete <id> [flags]

Flag	Description
-f, --force	Skip confirmation prompt

Caution

Delete is permanent and cannot be undone via the CLI. Prefer close unless you are certain.

open

redmine issues open <id>

Constructs the issue URL from your configured Redmine server and opens it in your default browser.

redmine issues open 123   # → https://redmine.example.com/issues/123

browse

redmine issues browse [flags]

Opens an interactive terminal browser for issues. Accepts the same filter flags as list.