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.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a9135d255898e9e287d8492e1f5e9dff50565fa7f16089b8dd527f2e05381f9a |
|
MD5 | 82ddbe21e3555df35f0a11cb5abc5923 |
|
BLAKE2b-256 | fd976819f3291705afbeb0e78c3af5dba87026db4dd44f6a74700fcdc7115f23 |