Command-line Kanbanize interface
JavaScript
Switch branches/tags
Latest commit d4ee289 Sep 18, 2016 @TehShrike committed on GitHub Updating maintenance status
Permalink
Failed to load latest commit information.
images ok fine I'll scale the images or whatever Apr 5, 2014
.npmignore
board_columns.js Fixed bug caused during LevelUP upgrade Oct 12, 2015
collapse_arguments.js Switched to using lieutenant for routing Apr 8, 2014
comment.js Can now view the current task and add comments Apr 10, 2014
editor.js Making tmp directory cross-platform Jun 30, 2014
index.js Working a task sets you as the assignee Sep 14, 2015
kanbanize_api.js Removing unnecessary solo levelUp get Apr 8, 2014
package.json
readme.md Updating maintenance status Sep 18, 2016
state.js Using node core to get user's home directory Jun 18, 2016
subtask.js Can now view the current task and add comments Apr 10, 2014
task.js Feature complete Apr 5, 2014
task_table.js Just a bit of lint-provoked refactoring Oct 12, 2015

readme.md

I switched jobs so I'm not using Kanbanize right now. I would be happy to assist anyone in debugging or adding to this library, and would be willing to hand ownership over to anyone interested. Open an issue or ping me on Twitter for either.

k

A cli for Kanbanize, so I don't have to go use the web UI for frequent operations.

What are my frequent operations, you ask? Well, let me tell you!

  • I look at the tasks assigned to me, and see which column they're in
  • I add to the checklists of my tasks
  • I check things off of those checklists
  • I move tasks to other columns (hopefully to the right) when appropriate

Other people will likely have other workflows than me. For now, this software represents my normal interactions with Kanbanize - but it could represent yours too! Pull requests or issues or whatever are welcome. If you hate or have otherwise strong emotions about the app, be sure to tell me on Twitter.

Install

Install node.js if it's not already on your machine, and then run

sudo npm install -g kanbanize-cli

(you'll obviously want to skip the sudo if you're on Windows)

Set up

k set key [api key] The API key you can get from the web ui, from the top-right menu dropdown under "API"

k set domain [domain name] The domain name where you visit Kanbanize. Could be company-specific, may just be kanbanize.com

k set board [board id] The board you want to interact with. You can get this from the dashboard, by mousing-over the right side of the list of boards, or you can just grab it from the url when you open up the board.

k set user [username] Your username. Case sensitive. This is used to filter down tasks so that you'll just see the ones that are assigned to you.

k set columns [column names] A comma-separated list of column names from the board. Case sensitive. Only tasks in these columns will be displayed. If you want to try to fit all the columns in your terminal, set to "all".

k set editor [editor] Your favorite terminal editor for editing task descriptions or adding long comments. Example: k set editor vim

If you want to check the current value of any of the settings above, you can see it by typing k get [setting name].

Usage

To refresh your memory on usage from the command-line, just run k and it will echo out the cheat sheet.

View your tasks

k tasks

k tasks

k tasks all

Shows you all tasks, even the ones that aren't assigned to you.

Add a task

k add task [template name] [task title]

New tasks go into the backlog. The template name is case sensitive.

Select a task

k work [task id]

Sets the "current" task being worked, and sets the task to be assigned to you.

This task id will be used for all other task-specific commands when you don't specify the task id manually.

View task details

k details [OPTIONAL task id]

Spits out the task description, all comments, and all subtasks.

Edit the task description

k description [OPTIONAL task id]

Opens your selected editor to make changes to the description. Text-only, any HTML styling previously on the task will be lost.

View subtasks

k subtasks [OPTIONAL task id]

k subtasks

If you don't type in the task id, subtasks will be shown for whatever task you said you were working.

Add a subtask

k add subtask [subtask title]

Mark a subtask as completed

k complete [subtask id]

Add a comment

k add comment [OPTIONAL comment]

If you don't type in the comment text on the command-line, your editor will open and whatever you save there will be added as a new comment on the task.

Move a task to a different column

k move [left|right] [OPTIONAL taskid]

Block or unblock a task

k block [reason]

k unblock [OPTIONAL task id]

Run arbitrary functions against the API

k api [api function] [header1 value1 [header2 value2 ...]]

Run any of the Kanbanize API functions you like and view the resulting JSON. Your API key and the current board id will be automatically passed in to every call.

License

WTFPL

So, you know, do whatever you want! Which is what you would have done anyway, unless I seemed like a guy who could afford lots of lawyers. (I'm not)