Asana

Tools for interacting with the Asana API

Usage

1. Grab the Project Id from the URL when viewing it
2. Visit Settings > Apps > Developer apps, create a Personal Access Token

export ASANA_API_KEY=<access-token>

stack build
stack exec -- <tool> --project <project-id>

ENV

You can persist your API key in ~/.env.asana if you'd rather not set it on each run.

echo "ASANA_API_KEY=<access-token>" >> ~/.env.asana

Tools

start-iteration

• List Stories in the project
• Warn for unexpected things like already-completed stories
• Show the points totals to document for starting the iteration

close-iteration

• List Stories in the project
• Warn for unexpected things like missing carry
• Show the points totals to document for closing the iteration

debt-evaluation

• Collects cost/impact/virality of debt tasks
• Calculates actionability
• Sets actionability on tasks

bug-reproduction

• List Bugs completed since we started tracking this information
• Warn for Bugs lacking this information
• Report totals for reproduced vs not

update-task

• Update custom field values on a Task

To update the foo custom field to 42 on Task 123:

% update-task --set foo:42 123

More than one --set option can be given at once.

If foo is not a custom field, the update will do nothing. The value 42 will be interpreted as a Number or Enum name depending on the type of foo, which is read from the Task before performing the update.