a62ae17866 | ||
---|---|---|
.gitignore | ||
LICENSE | ||
Procfile | ||
README.md | ||
app.json | ||
nextaction.py | ||
requirements.txt |
README.md
NextAction
A more GTD-like workflow for Todoist. Uses the REST API to add and remove a @next_action
label from tasks.
This program looks at every list in your Todoist account.
Any list that ends with -
or =
is treated specially, and processed by NextAction.
Note that NextAction requires Todoist Premium to function properly, as labels are a premium feature.
Requirements
- Python 2.7, Python 3.0+ is unsupported at the moment
todoist-python
package.
Activating NextAction
Sequential list processing
If a list ends with -
, the top level of tasks will be treated as a priority queue and the most important will be labeled @next_action
.
Importance is determined by order in the list
Parallel list processing
If a list name ends with =
, the top level of tasks will be treated as parallel @next_action
s.
The waterfall processing will be applied the same way as sequential lists - every parent task will be treated as sequential. This can be overridden by appending =
to the name of the parent task.
Executing NextAction
You can run NexAction from any system that supports Python, and also deploy to Heroku as a constant running service
Running NextAction
NextAction will read your environment to retrieve your Todoist API key, so to run on a Linux/Mac OSX you can use the following commandline
TODOIST_API_KEY="XYZ" python nextaction.py
Heroku Support
This package is ready to be pushed to a Heroku instance with minimal configuration values:
TODOIST_API_KEY
- Your Todoist API KeyTODOIST_NEXT_ACTION_LABEL
- The label to use in Todoist for next actions (defaults to next_action)TODOIST_SYNC_DELAY
- The number of seconds to wait between syncs. (defaults to 5)TODOIST_INBOX_HANDLING
- What method to use for the Inbox, sequence or parallel (defaults to parallel)TODODIST_PARALLEL_SUFFIX
- What sequence of characters to use to identify parallel processed projects (defaults to =)TODODIST_SERIAL_SUFFIX
- What sequence of characters to use to identify serial processed projects (defaults to -)