https://github.com/freckle/asana
Asana API tools for Freckle workflows
https://github.com/freckle/asana
ghvm-managed
Last synced: 3 months ago
JSON representation
Asana API tools for Freckle workflows
- Host: GitHub
- URL: https://github.com/freckle/asana
- Owner: freckle
- License: mit
- Created: 2019-07-26T16:53:16.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2025-03-21T22:28:23.000Z (about 1 year ago)
- Last Synced: 2025-05-12T21:47:42.691Z (about 1 year ago)
- Topics: ghvm-managed
- Language: Haskell
- Homepage:
- Size: 142 KB
- Stars: 3
- Watchers: 20
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Asana
Tools for interacting with the Asana API
## Usage
1. Grab the Project Id from the URL when viewing it
1. Visit *Settings > Apps > Developer apps*, create a Personal Access Token
```console
export ASANA_API_KEY=
stack build
stack exec -- --project
```
### ENV
You can persist your API key in `~/.env.asana` if you'd rather not set it on each run.
```
echo "ASANA_API_KEY=" >> ~/.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:
```console
% 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.