ScrumOps¶

So you’ve heard of DevOps, FinOps, DevSecOps - what all of these have in common is that they embrace command line tools as being more productive than the desktop or the browser.

We believe this is true for Agile/Scrum project management too.

Scrum meetings are supposed to be fast-paced, however, this is invariably slowed down while the scrum master faffs around in Jira or Trello finding and updating the ticket and then finding and viewing the next ticket.

Taiga¶

Clearly a good agile project management web-based system is still required. We are using Taiga as this component. We’ve even got extensions for this to provide an email API for ticketing.

Taiga has an excellent RESTFul API - and we do need API’s to create a command-line client. The better the API’s - the more featureful the client.

Taiga also has a migration path from some other popular project management platforms.

Project management is filled with philosophies, methodologies, and nomenclature that is by no means universally agreed. We’re cutting through all that - and if it’s not represented within Taiga, it’s off the table. So we talk about Epics, User Stories, Tasks, Issues, Sprints, Swimlanes, Projects all within the context of what is implemented within Taiga.

Command Line¶

We’ve used the wonderful python click libraries to create a fantastic command to speed up your stand-ups. And the best thing about it is err bash - because history… you can easily find and run yesterdays commands today.

$ taiga stories list <project>
$ taiga tasks update <project> --status done --ref 24 --ref 36
$ taiga config show

Options¶

taiga¶

Taiga scrum management command line tool

In a nutshell:

* Tasks have descriptions, watcher’s, status’s and may be assigned
* Issues are tasks with priorities, severities, and due dates
* Epics are groupings of Stories
* Stories are groupings of Tasks
* Sprints are groups of Tasks and Issues within a scheduled period.
* Projects are groups of Sprints, Epics, Stories, and Issues
* Everthing may be commented upon and tagged.

taiga [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

--version¶: Show the version and exit.

auth¶

set up and/or refresh your access keys

taiga auth [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

logout¶

remove access token from configuration

taiga auth logout [OPTIONS]

refresh¶

refresh your API key

if your key has expired; you will have to do another login

taiga auth refresh [OPTIONS]

config¶

customise your taiga tool

you can edit your ~/.taiga.yaml to change how this tool behaves.

taiga config [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

reset¶

reset your configuration to system defaults

taiga config reset [OPTIONS]

show¶

show your taiga tool configuration

taiga config show [OPTIONS]

Options

-o, --output-format <output_format>¶

Output format

Default:: 'yaml'
Options:: json | yaml

write¶

write your taiga tool configuration

taiga config write [OPTIONS]

Options

-o, --output-format <output_format>¶

Output format

Default:: 'yaml'
Options:: json | yaml

epics¶

manage project epics

taiga epics [OPTIONS] COMMAND [ARGS]...

comment¶

add a comment to an epic

taiga epics comment [OPTIONS] PROJECT [REF]...

Options

-c, --comment <comment>¶: Required your comment text

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

create¶

create an epic in PROJECT

taiga epics create [OPTIONS] PROJECT

Options

-s, --subject <subject>¶: Required short title

-d, --description <description>¶: more details

Arguments

PROJECT¶: Required argument

get¶

retrieve full epic details

taiga epics get [OPTIONS] PROJECT REF

Options

-a, --all¶

Arguments

PROJECT¶: Required argument

REF¶: Required argument

issues¶

display the issues in this story(s)

taiga epics issues [OPTIONS] PROJECT [REF]...

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

list¶

list epics in project (or all)

taiga epics list [OPTIONS] [PROJECT]...

Arguments

PROJECT¶: Optional argument(s)

story¶

create a story within an epic

taiga epics story [OPTIONS] PROJECT REF

Options

-s, --subject <subject>¶: Required short title

-d, --description <description>¶: more details

-i, --status <status>¶: initial status

-i, --assign <assign>¶: assigned to

Arguments

PROJECT¶: Required argument

REF¶: Required argument

tagadd¶

add a tag(s) to an epic

taiga epics tagadd [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

tagrm¶

remove tag(s) from an epic

taiga epics tagrm [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

tasks¶

display the tasks in this story(s)

taiga epics tasks [OPTIONS] PROJECT [REF]...

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

update¶

edit the epic

taiga epics update [OPTIONS] PROJECT [REF]...

Options

--status <status>¶

--subject <subject>¶

--blocked¶

--closed¶

--assigned <assigned>¶

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

issues¶

manage project issues

taiga issues [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

comment¶

add a comment to an issue

taiga issues comment [OPTIONS] PROJECT [REF]...

Options

-c, --comment <comment>¶: Required your comment text

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

create¶

taiga issues create [OPTIONS] PROJECT

Options

-s, --subject <subject>¶: Required short title

-d, --description <description>¶: Required more details

-p, --priority <priority>¶: urgency

-i, --status <status>¶: initial status

-t, --issue-type <issue_type>¶: issue type

-c, --severity <severity>¶: criticality/impact

--due <due>¶: due date

Arguments

PROJECT¶: Required argument

get¶

retrieve full issue details

taiga issues get [OPTIONS] PROJECT REF

Options

-a, --all¶

Arguments

PROJECT¶: Required argument

REF¶: Required argument

list¶

list issues of project (or all)

taiga issues list [OPTIONS] [PROJECT]

Arguments

PROJECT¶: Optional argument

tagadd¶

add a tag(s) to an issue

taiga issues tagadd [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

tagrm¶

remove tag(s) from an issue

taiga issues tagrm [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

update¶

taiga issues update [OPTIONS] PROJECT REF

Options

--status <status>¶

--subject <subject>¶

--severity <severity>¶

--issue-type <issue_type>¶

--priority <priority>¶

--description <description>¶

--assigned <assigned>¶

Arguments

PROJECT¶: Required argument

REF¶: Required argument

members¶

manage memberships for [server] users

a membership is a role within a project

taiga members [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

create¶

add new user as a project/team member

taiga members create [OPTIONS] PROJECT

Options

--email <email>¶: Required

--role <role>¶: Required

--password <password>¶: Required

--full-name <full_name>¶: Required

--accepted-terms¶

Arguments

PROJECT¶: Required argument

delete¶

remove user as project/team member

taiga members delete [OPTIONS] EMAIL PROJECT

Arguments

EMAIL¶: Required argument

PROJECT¶: Required argument

link¶

add existing user as a project/team member

taiga members link [OPTIONS] PROJECT

Options

--email <email>¶: Required email (or username) of member

--role <role>¶: Required

Arguments

PROJECT¶: Required argument

list¶

list members

taiga members list [OPTIONS] [PROJECT]...

Arguments

PROJECT¶: Optional argument(s)

projects¶

manage projects

taiga projects [OPTIONS] COMMAND [ARGS]...

comment¶

add a comment to an project

taiga projects comment [OPTIONS] PROJECT

Options

-c, --comment <comment>¶: Required your comment text

Arguments

PROJECT¶: Required argument

create¶

create a new project

taiga projects create [OPTIONS] NAME

Options

-d, --description <description>¶: Required The description of the project

-t, --creation-template <creation_template>¶

creation template slug name

Default:: 'scrum'

-p, --private¶

make the project private?

Default:: False

Arguments

NAME¶: Required argument

delete¶

delete project

taiga projects delete [OPTIONS] PROJECT

Arguments

PROJECT¶: Required argument

get¶

returns details for creating issues/epics etc in the project

taiga projects get [OPTIONS] PROJECT

Options

-a, --all¶

Full information

Default:: False

Arguments

PROJECT¶: Required argument

list¶

list projects

taiga projects list [OPTIONS]

members¶

show/assign team members to project

taiga projects members [OPTIONS] PROJECT

Options

-r, --role <role>¶: Role name

-u, --user <user>¶: Username/email

Arguments

PROJECT¶: Required argument

tagadd¶

add a tag(s) to an project

taiga projects tagadd [OPTIONS] PROJECT

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

tagrm¶

remove tag(s) from an project

taiga projects tagrm [OPTIONS] PROJECT

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

update¶

taiga projects update [OPTIONS] PROJECT

Options

--name <name>¶

--description <description>¶

--is-public¶

Arguments

PROJECT¶: Required argument

search¶

search taiga

taiga search [OPTIONS] TEXT... COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

-p, --project <project>¶: project name to search

Arguments

TEXT¶: Required argument(s)

server¶

manage your back-end taiga server

in the future, these features will require an admin user

taiga server [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

init¶

set up your taiga with our best-practice project templates

taiga server init [OPTIONS]

Options

-s, --skip¶

skip if template already exists

Default:: False

-r, --refresh¶

refresh the templates with the latest copy here

Default:: False

metrics¶

retrieve usage metrics

taiga server metrics [OPTIONS]

users¶

manage user access to your taiga

a user is an account/login

taiga server users [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

delete¶

remove user

taiga server users delete [OPTIONS] USERNAME

Arguments

USERNAME¶: Required argument

get¶

retrieves user details

taiga server users get [OPTIONS] USERNAME

Arguments

USERNAME¶: Required argument

list¶

list users

taiga server users list [OPTIONS]

register¶

taiga server users register [OPTIONS] USERNAME

Options

--email <email>¶: Required

--password <password>¶: Required

--full-name <full_name>¶: Required

--accepted-terms¶

--public¶: send invitation (otherwise private)

--private¶: private (no sending invitation)

Arguments

USERNAME¶: Required argument

sprints¶

manage project sprints (ie milestones)

taiga sprints [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

comment¶

add a comment to a sprint

taiga sprints comment [OPTIONS] ID

Options

-c, --comment <comment>¶: Required your comment text

Arguments

ID¶: Required argument

get¶

retrieve full epic details

taiga sprints get [OPTIONS] ID

Options

-a, --all¶

Arguments

ID¶: Required argument

issues¶

list issues within the sprint name

taiga sprints issues [OPTIONS] PROJECT SPRINT

Arguments

PROJECT¶: Required argument

SPRINT¶: Required argument

list¶

list sprints of project

taiga sprints list [OPTIONS] [PROJECT]...

Arguments

PROJECT¶: Optional argument(s)

tagadd¶

add a tag(s) to an sprint

taiga sprints tagadd [OPTIONS] ID

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

ID¶: Required argument

tagrm¶

remove tag(s) from an sprint

taiga sprints tagrm [OPTIONS] ID

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

ID¶: Required argument

tasks¶

tasks within the sprint name

taiga sprints tasks [OPTIONS] PROJECT SPRINT

Arguments

PROJECT¶: Required argument

SPRINT¶: Required argument

update¶

edit the sprint

taiga sprints update [OPTIONS] ID

Options

--name <name>¶

--start <start>¶

--finish <finish>¶

Arguments

ID¶: Required argument

stories¶

manage project user stories

taiga stories [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

comment¶

add a comment to an story

taiga stories comment [OPTIONS] PROJECT [REF]...

Options

-c, --comment <comment>¶: Required your comment text

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

create¶

create a user story in (kanban) project

taiga stories create [OPTIONS] PROJECT

Options

-s, --subject <subject>¶: Required short title

-d, --description <description>¶: more details

-i, --status <status>¶: initial status

-a, --assign <assign>¶: assign to user

Arguments

PROJECT¶: Required argument

get¶

retrieve full user story details

taiga stories get [OPTIONS] PROJECT REF

Options

-a, --all¶

Arguments

PROJECT¶: Required argument

REF¶: Required argument

issues¶

display the issues in this story(s)

taiga stories issues [OPTIONS] PROJECT [REF]...

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

list¶

list user stories of project (or all)

taiga stories list [OPTIONS] [PROJECT]...

Arguments

PROJECT¶: Optional argument(s)

tagadd¶

add a tag(s) to an story

taiga stories tagadd [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

tagrm¶

remove tag(s) from an story

taiga stories tagrm [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

tasks¶

display the tasks in this story(s)

taiga stories tasks [OPTIONS] PROJECT [REF]...

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

update¶

edit the story(s)

taiga stories update [OPTIONS] PROJECT [REF]...

Options

--status <status>¶

--subject <subject>¶

--blocked¶

--closed¶

--assigned <assigned>¶

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

tasks¶

manage project tasks

taiga tasks [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

comment¶

comment upon task

taiga tasks comment [OPTIONS] PROJECT REF

Options

-c, --comment <comment>¶: Required comment upon task

Arguments

PROJECT¶: Required argument

REF¶: Required argument

create¶

create a task in a user story

taiga tasks create [OPTIONS] PROJECT STORYREF

Options

-s, --subject <subject>¶: Required short title

-d, --description <description>¶: more details

--status <status>¶

--assigned <assigned>¶

Arguments

PROJECT¶: Required argument

STORYREF¶: Required argument

get¶

retrieve full task details

taiga tasks get [OPTIONS] PROJECT REF

Options

-a, --all¶

Arguments

PROJECT¶: Required argument

REF¶: Required argument

list¶

list tasks

taiga tasks list [OPTIONS] [PROJECT]...

Arguments

PROJECT¶: Optional argument(s)

tagadd¶

add a tag(s) to an story

taiga tasks tagadd [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

tagrm¶

remove tag(s) from an story

taiga tasks tagrm [OPTIONS] PROJECT [REF]...

Options

-t, --tag <tag>¶: Required your tag; you can use this multiple times

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

update¶

edit the story

taiga tasks update [OPTIONS] PROJECT [REF]...

Options

--status <status>¶

--subject <subject>¶

--blocked¶

--closed¶

--assigned <assigned>¶

Arguments

PROJECT¶: Required argument

REF¶: Optional argument(s)

watchers¶

manage watchers

taiga watchers [OPTIONS] COMMAND [ARGS]...

Options

-v, --verbosity <LVL>¶: Either CRITICAL, ERROR, WARNING, INFO or DEBUG

add¶

add a watcher/user to a project’s issue/task etc

taiga watchers add [OPTIONS] PROJECT

Options

--email <email>¶: email address (and name if rfc822) of user

--password <password>¶

--full-name <full_name>¶: full name - required if new user

-u, --username <username>¶: username (rather than email)

--role <role>¶: project role to assign

-i, --issue <issue>¶: issue(s) to watch

-t, --task <task>¶: tasks(s) to watch

-e, --epic <epic>¶: epic(s) to watch

-s, --story <story>¶: user story(s) to watch

Arguments

PROJECT¶: Required argument

email¶

send email(s) of issue, task,… if no emails/usernames set; then email every watcher

taiga watchers email [OPTIONS] PROJECT

Options

--email <email>¶: email address of user

-u, --username <username>¶: username of user

--from-me¶: reply-to me instead of taiga mailbox

-i, --issue <issue>¶: issue(s) ref to watch

-t, --task <task>¶: tasks(s) ref to watch

-e, --epic <epic>¶: epic(s) ref to watch

-s, --story <story>¶: user story(s) ref to watch

Arguments

PROJECT¶: Required argument

remove¶

remove a watcher from issues, tasks et al

taiga watchers remove [OPTIONS] PROJECT

Options

--email <email>¶: email address of user

-u, --username <username>¶: username of user

-i, --issue <issue>¶: issue(s) ref to watch

-t, --task <task>¶: tasks(s) ref to watch

-e, --epic <epic>¶: epic(s) ref to watch

-s, --story <story>¶: user story(s) ref to watch

Arguments

PROJECT¶: Required argument

ScrumOps¶

Taiga¶

Command Line¶

Options¶

taiga¶

auth¶

login¶

logout¶

refresh¶

config¶

reset¶

show¶

write¶

epics¶

comment¶

create¶

get¶

issues¶

list¶

story¶

tagadd¶

tagrm¶

tasks¶

update¶

issues¶

comment¶

create¶

get¶

list¶

tagadd¶

tagrm¶

update¶

members¶

create¶

delete¶

link¶

list¶

projects¶

comment¶

create¶

delete¶

get¶

list¶

members¶

tagadd¶

tagrm¶

update¶

search¶

server¶

init¶

metrics¶

users¶

delete¶

get¶

list¶

register¶

sprints¶

comment¶

get¶

issues¶

list¶

tagadd¶

tagrm¶

tasks¶

update¶

stories¶

comment¶

create¶

get¶

issues¶

list¶

tagadd¶

tagrm¶

tasks¶

update¶

tasks¶

comment¶

create¶

get¶

list¶