tm - Command line interface for TaskMapper¶ ↑
This application provides an easy to use interface to interact with any TaskMapper provider in an standard way.
gem install tm
Also it will be include with TaskMapper so no need to install it alone.
tm --provider kanbanpad --authentication 'token:kdkdjdkd,username:username'
Refer to particular providers documentation to know which fields they need for authentication. After using this mechanism for authentication is better to pass the ‘initconfig` command to not be writing the credentials for each command. This will use the specified provider name as default.
Available options
-
–format=pretty|csv|table (Default: pretty)
-
–no-color
This is the default operation on projects. It will list all the projects for a given user. (Default: –list=all)
tm project --list=all --format=table
tm project --list=single --search-attribute='name:Project'
Available options
-
–format=pretty|csv|table (Default: pretty)
-
–no-color
This is the default operation on tasks. It will list all the tasks for a given project.
Note: For the –project-attribute option you should send an attribute for the project to search, ex. ‘name:test-project’ (Default –list=all)
tm task --project-attribute='name:test-project'
tm task --list=first --project-attribute='name:test-project'
tm task --list=last --project-attribute='name:test-project'
tm task --list=single --project-attribute='name:test-project' --task-attribute='title:test-task'
This particular needs needs –project-attribute and –task-attribute to work on an existing project and task respectevily.
tm task --project-attribute='name:test-project' --task-attribute='title:testing' --create-task
Available options
-
–format=pretty|csv|table (Default: pretty)
-
–no-color
This is the default operation on comments. It will list all the comments for a given task.
Note: This command is dependant of two other options, –project-attribute and –task-attribute. The –project-attribute is the same as the task command, it’s needed to figure out which project the command will execute upon, the –task-attribute is needed to figure out on which particular task the user will retrieve the comments. (ex. ‘title:test-task’)
tm comment --project-attribute='name:test-project' --task-attribute='title:test-task'
This command needs three mandatory options –project-attribute, –task-attribute and –comment-attribute.
tm comment --project-attribute='name:test-project --task-attribute='title:test-task' --command-attribute='body:testing' --create-comment
For more help
tm help tm help <command>