avanier's banner

jira

Godzilla: King of the Monsters (1956)
ゴジラ

Notes on Jira, a project management tool. I use it at $DAYJOB (you likely do too).

acli

I’ve been using ACLI in my day-to-day tasks.

brew tap atlassian/homebrew-acli
brew install acli
acli jira auth login --web

Create an item (assigned to yourself):

acli jira workitem create \
  --summary "Do something" \
  --description "Details, details, details" \
  --project "PROJ" \
  --type "Task" \
  --assignee "@me" \
  --label "improvement"

Or if you have a template ready:

acli jira workitem create \
  --summary "Do something" \
  --description-file "./template.md" \
  --project "PROJ" \
  --type "Task" \
  --assignee "@me" \
  --label "improvement"

View an item’s details in terminal or on a browser:

acli jira workitem view PROJ-123
acli jira workitem view PROJ-123 --web

Update an item’s status:

acli jira workitem transition \
  --key PROJ-123 \
  --status "In Progress"

Assign an item to myself:

acli jira workitem assign --key PROJ-123 --assignee "@me"

JQL is a search language for querying issues. Here’s how to view assigned and unfinished items in the current sprint (useful for daily standups):

acli jira workitem search --jql "assignee = 'account@work.com' \
  and (status = 'To Do' or status = 'In Progress') \
  and sprint in openSprints()" \
  --fields "issuetype,key,priority,status,summary"

View items in the upcoming sprint:

acli jira workitem search --jql "project = 'PROJ' and sprint in futureSprints()

View items with no assigned story points:

acli jira workitem search --jql "project = 'PROJ' and 'Story Points' is EMPTY"