ALFRED TODOIST WORKFLOW
Add and search
Todoist
tasks straight from
Alfred. It uses Todoist v8
REST API.
| Getting started | Installation | Configuration | Usage | Contributing |
|---|---|---|---|---|
Getting started
-
For this workflow to work you need
version
3.xof Alfred and a powerpack licence. - Node.js
Installation
Download and import workflow.
Configuration
| Name | Notation | Explanation |
|---|---|---|
| token |
^[0-9a-fA-F]{40}$
(default empty)
|
The todoist API token. |
| language |
en, da,
pl, zh,
ko, de,
pt, ja,
it, fr,
sv, ru,
es,
nl (default
en)
|
The language for natural language date processing (by todoist) and to calculate time to complete a task. |
| cache_timeout |
A positive number (default
3600, an hour)
|
The time (in seconds) until the cache is refreshed (until that time todoist information is stored locally to make things a little faster) |
| anonymous_statistics |
true or
false (default
true)
|
Doesn't do much at the moment but I intent to use it to track installs |
todo:setting token {api token}
Example:
todo:setting token
2d2e2a334c5f36e7a7c43b46e
todo:setting language {language}
Example: todo:setting language nl
todo:setting cache_timeout {time in
seconds}
Example:
todo:setting cache_timeout 13
todo:setting anonymous_statistics {true
or false}
Example:
todo:setting anonymous_statistics
false
Usage
| Name | Notation | Explanation |
|---|---|---|
| task |
Any text except ,
|
The task title. |
| date | A date string | See the Todoist documentation for supported date formats. |
| project |
Either #personal or
#[next actions]
|
Use either the hashtag notation or bracket notation if the project name has spaces in it. The project name is case insensitive. |
| label | @label |
Label names can't contain any whitespace characters. Labels are case insensitive. |
| priority |
Either p2 or
!!2
|
A value between
1 (urgent) and
4 (normal)
|
Search for tasks
todos {query}
Query
Any search query one character or longer. Uses fuzzy search to find the tasks.
Example: todos car => returns
(because of fuzzy search):
- Rent car
- New cat recipe's
- Cut Gras tomorrow
Create task
todo {task}, {date}
Example:
todo Get things done, tomorrow @ 9
Example:
todo Build tree house #home !!2 @15min,
tomorrow @ 9
Changelog
View CHANGELOG.md
Contributing
Instructions
- Fork and clone the repo
- Install dependacies
- Symlink to project workflow folder
git clone https://github.com/YOUR-USERNAME/alfred-worflow-todoist
npm install
npm run setup:dev
Build
Create a new build with
npm run build
Run tests
Run Jest test suite with:
npm run test
npm run test:prod
Or run a watcher with
npm run test:watch
Commits
For commits I follow the
angular commit guidelines and
use semantic release to
automate builds, semver version updates
and changelog creation. The way to make
sure this all works is to run:
npm run commit
Which guides you through the motions
