redmine-cli-modified

RedmineCLI

A NodeJS, stateful, console-based Redmine client.

Installation & Setup

npm install -g redmine-cli-modified

Connect to your Redmine instance.

>redmine connect http://your.server/redmine yourApiKey

Note: Unless you don't want to switch to another Redmine instance you only need to call this once.

You are all set, have fun :)

Usage

Display available commands and options.

>redmine --help
Usage: redmine [options] [command]
 
Commands:
connect <url> <apiKey>                        Connect to server using API key for authentication.
projects                                      Display projects.
project <identifier>                          Display project details.
update-project [options] <identifier>         Update the specified project.
create-project [options] <name> <identifier>  Create a new project.
issues [options]                              Display issues.
issue [options] <id>                          Display issue details.
update-issue [options] <id>                   Update the specified issue.
create-issue [options] <project> <subject>    Create a new issue.
statuses                                      Display available issue statuses.
trackers                                      Display available trackers.
priorities                                    Display available priorities.
users                                         Display users (requires admin priviliges).
user <id>                                     Display user details (requires admin priviliges).
open <id>                                     Open issue in default browser.
 
 
Options:
  -h, --help     output usage information
  -V, --version  output the version number

Or display the options of a certain command.

>redmine issues --help
  Usage: issues [options]
 
  Display issues.
 
  Options:
    -h, --help                 output usage information
    -p, --project <project>    Only display issues for the specified project.
    -P, --priority <priority>  Only display issues with specified priority.
    -a, --assignee <assignee>  Only display issues for the specified assignee.
    -s, --status <status>      Only display issues with the specified status.
    -t, --tracker <tracker>    Only display issues for the specified tracker.
    -m, --me                   Only display issues assigned to me.
    -o, --open                 Only display open issues.
    -c, --closed               Only display closed issues.

Example

Display all issues assigned to you with status New.

>redmine issues --me --status=New
ID  TRACKER  STATUS  PRIORITY  ASSIGNEE        SUBJECT
#2  Bug      New     High      Admin Istrator  This is a bug. 
#1  Feature  New     Urgent    Admin Istrator  This is a feature. 

Display a certain issue with history.

>redmine issue 2 --history
BUG #2 
This is a feature.
Added by Admin Istrator a month ago. Updated a day ago.
 
STATUS  PRIORITY  ASSIGNEE
New     Normal    Admin Istrator
 
DESCRIPTION
This is a feature description.
HISTORY
 * Updated by Admin Istrator 21 days ago.
   Status changed from 'In Progress' to 'New'.
 * Updated by Admin Istrator 21 days ago.
   Tracker changed from 'Feature' to 'Bug'.
 * Updated by Admin Istrator 21 days ago.
   Assignee changed from 'nobody' to 'John Doe'.
 * Updated by Admin Istrator 14 days ago.
   Assignee changed from 'John Doe' to 'Admin Istrator'.
 * Updated by Admin Istrator a day ago.
   Priority changed from 'High' to 'Normal'.

Note: In order to resolve some properties within the history, displaying an issue with history may take a few moments longer. If you are not interested in the history just skip the according option.

Remark

It's still under active development!

Changelog

v0.8.12

• New feature
  • add custome query for redmine to list un-resolved or un-closed issues
• Fixed
  • unit test

v0.8.11

• Fixes
  • set default issue list limit to 100 and offset from 0

v0.8.10

• New feature
  • print parent id in issue list page

v0.8.8

• New feature
  • print parent id if exist

v0.8.7

• Bug fix
• fix type error of 'parent' in all actions

v0.8.6

• Bug fix
• fix type error of 'parent'

v0.8.5

• New feature
• add alias of 'issue detail' to 'id'

v0.8.4

• New feature
• add option for 'parent'
• save configuration at user home directory
• add alias of 'create-issue' to 'ci', 'update-issue' to 'ui'

v0.8.3

• New feature
• add option for 'notes' & 'done ratio'

v0.8.2

• New feature
• add custom field 'sprint' to 'Update Issues' & 'Create Issues'

v0.8.0

• New features
• Update projects
• Create projects
• Improvements
• Extended issue details

v0.7.0

• New features
  • Update Issues
  • Create Issues
  • Display user details
• Improved stability
  • 100% test coverage

v0.6.0

• Several improvements
  • Memberlist in project details is now grouped by role
  • Removed table borders to be able to display more actual data on screen
  • Added bold formatting for section headers
  • Connect command is now validating provided urland apiKey
  • Enhanced some templates to either hide sections when no data is set or to display 'XX not set' message
• New features
  • Filters for issue list do now accept human readable names instead of internal ids
  • Issue details may now also be displayed with issue history
  • Added new 'users' command to display list of users
• Fixes
  • Fixed text of some error messages