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 filtersViewing issues
bash
rmn issue view 42 # View issue detailsCreating 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-31All 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 fieldsOnly 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 noteDeleting issues
bash
rmn issue delete 42 # Delete with confirmation prompt
rmn issue delete 42 -y # Skip confirmationProjects
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 deleteUsers
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 -yTime 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 -yMemberships
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 -yWiki 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 -yTrackers & Statuses (reference data)
bash
rmn tracker list # List trackers (Bug, Feature, etc.)
rmn status list # List issue statusesCommand Aliases
| Command | Aliases |
|---|---|
rmn issue list | ls |
rmn issue view | show, get |
rmn issue create | new |
rmn issue delete | rm |
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 42Global Flags
| Flag | Description |
|---|---|
--output | Output format: table (default) or json |
--redmine-url | Override Redmine instance URL |
--api-key | Override 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'