Skip to content

Usage

Issues

Listing issues

bash
rmn issue list                                    # List open issues (default limit: 25)
rmn issue list -p my-project                      # Filter by project
rmn issue list -s closed                          # Filter by status (open, closed, *, or status ID)
rmn issue list -a me                              # Issues assigned to you
rmn issue list -t 2                               # Filter by tracker ID
rmn issue list --sort updated_on:desc             # Sort by column
rmn issue list -l 50 --offset 100                 # Pagination
rmn issue list -p my-project -s closed -a me      # Combine filters

Viewing issues

bash
rmn issue view 42                                 # View issue details

Creating issues

bash
rmn issue create -p my-project -s "Bug report"
rmn issue create -p my-project -s "Feature request" -d "Detailed description" \
  -t 2 --priority 3 -a 5 --start-date 2025-01-01 --due-date 2025-03-31

All create flags: --project/-p (required), --subject/-s (required), --description/-d, --tracker/-t, --priority, --assignee/-a, --category, --version, --parent, --start-date, --due-date, --estimated-hours, --done-ratio.

Updating issues

bash
rmn issue update 42 --status 3                    # Change status
rmn issue update 42 -n "Work in progress"         # Add a note
rmn issue update 42 --done-ratio 50 --priority 2  # Update multiple fields

Only specified fields are changed; omitted fields remain unchanged. All create flags are available, plus --status and --notes/-n.

Closing issues

bash
rmn issue close 42                                # Close (status ID 5 by default)
rmn issue close 42 --status 6                     # Close with custom status ID
rmn issue close 42 -n "Fixed in v1.2"             # Close with a note

Deleting issues

bash
rmn issue delete 42                               # Delete with confirmation prompt
rmn issue delete 42 -y                            # Skip confirmation

Projects

bash
rmn project list                                  # List active projects
rmn project list --status archived                # Filter by status
rmn project view my-project                       # View by identifier or numeric ID
rmn project view my-project --include trackers,issue_categories
rmn project create --name "New Project" --identifier new-project -d "Description"
rmn project update my-project --name "Renamed"
rmn project archive my-project                    # Hide but preserve
rmn project unarchive my-project
rmn project delete my-project -y                  # Permanent delete

Users

bash
rmn user list                                     # List active users (admin required)
rmn user list --status 1 --name ali
rmn user view 42                                  # View user by numeric ID
rmn user view me                                  # Current user (whose API key is in use)

Versions

bash
rmn version list -p my-project                    # List versions/milestones
rmn version view 10
rmn version create -p my-project --name v1.0 --due-date 2026-06-01
rmn version update 10 --status locked
rmn version delete 10 -y

Time Entries

bash
rmn time-entry list                               # List all time entries visible to you
rmn time-entry list -p my-project --from 2026-01-01 --to 2026-03-31
rmn time-entry create --issue 42 --hours 1.5 -c "Debugging"
rmn time-entry create -p my-project --hours 2 --activity 9
rmn time-entry update 5 --hours 2.5
rmn time-entry delete 5 -y

Memberships

bash
rmn membership list -p my-project                 # List project members
rmn membership view 3
rmn membership create -p my-project --user 5 --role 3 --role 4
rmn membership update 3 --role 4
rmn membership delete 3 -y

Wiki Pages

bash
rmn wiki list -p my-project                       # List wiki pages
rmn wiki view Home -p my-project                  # View page content
rmn wiki view Home -p my-project --version 3      # Historical version
rmn wiki create Home -p my-project --text "h1. Hello"
rmn wiki update Home -p my-project --text "h1. Updated"
rmn wiki delete Home -p my-project -y

Trackers & Statuses (reference data)

bash
rmn tracker list                                  # List trackers (Bug, Feature, etc.)
rmn status list                                   # List issue statuses

Command Aliases

CommandAliases
rmn issue listls
rmn issue viewshow, get
rmn issue createnew
rmn issue deleterm
bash
rmn issue ls                    # Same as: rmn issue list
rmn issue show 42               # Same as: rmn issue view 42
rmn issue new -p proj -s "Bug"  # Same as: rmn issue create ...
rmn issue rm 42                 # Same as: rmn issue delete 42

Global Flags

FlagDescription
--outputOutput format: table (default) or json
--redmine-urlOverride Redmine instance URL
--api-keyOverride Redmine API key

JSON Output

Use --output json on any command for machine-readable output, useful for scripting and piping:

bash
rmn issue list --output json                      # JSON array of issues
rmn issue view 42 --output json                   # Full issue as JSON
rmn issue list -p my-project --output json | jq '.issues[].subject'

Released under the MIT License.