A loose wrapper around reminders-cli
Project description
Task (cade-task)
Task is a light CLI wrapper around Reminders.app (reminders-cli) that unifies use with dead-simple, sane defaults to remove friction from GTD.
Install
pipx:
pipx install cade-task
brew:
Building bottles of python modules is flaky, not currently maintained
brew install cadeef/tap/cade-task
Usage
Commands are aware of project context where available. Task assumes you store all of your projects in the same directory (defined with —-project-dir
), shell aliases are your friend.
Short flags exist for all options, but the long version is used here for clarity.
List Tasks
List tasks for your current project:
task list
Not in your project directory? No problem, specify the list you’d like to interact with:
task list —-list <yourgloriouslist>
The list selection convention is consistent throughout the app.
Add a Task
task add A glorious task that should be completed
Don’t worry about quotes unless you’re doing something funky, task will glue the arguments together for you.
Complete Tasks
Complete one or more tasks:
task complete 6 1 3
Tasks are completed in reverse numerical order (10...1) to avoid re-parsing the task list after each task is completed.
Open Reminders.app
Conveniently open (or bring to the foreground) Reminders.app:
task open
Additional usage information is available via —-help
on the command line.
Shell Aliases
The defaults may not work for you. Shell aliases are cheap and easy. Define a different project directory from bash:
TASK_PROJECT_DIR=“${HOME}/myprettyneatprojectdir”
# List tasks in current project
alias t=“task -d ${TASK_PROJECT_DIR} list”
# Add task in current project
alias ta=“task -d ${TASK_PROJECT_DIR} add”
# Complete task(s) in current project
alias tc=“task -d ${TASK_PROJECT_DIR} complete”
# Sync TODO|FIXME in current project
alias tsync=“task -d ${TASK_PROJECT_DIR} sync”
# List task lists
alias tl=“task lists”
# Open Reminders.app
alias to=“task open”
Tweak until your heart is content without monkeying yet another config file.
Caveats
- Task wraps Keith Smiley’s reminders-cli. Task is intended as a backend-agnostic wrapper that standardizes use without being tied to a specific implementation— I don’t want to retrain muscle memory if a new killer app comes along.
License
This project is distributed under an MIT license, see LICENSE for more information.
Made it this far? You deserve a hug.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cade_task-0.4.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7bb24ef2f8ffbd833b6fc72fb8cb61c09c6037c5d9bc8dbc997679872f6cd943 |
|
MD5 | 9bf39ef0ecc771857cb1e759ff66b326 |
|
BLAKE2b-256 | f9006f904925abc7be22ff0c5dfc323bf6b8524cb397e7febd8cc1a154f8e000 |