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.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 05cc2057c89fe4698b7ce6bd9300f2864899d420d1c55d14abeda4ef4574045e |
|
MD5 | beb41e82ebd9ca49c55f63bdb47e6f90 |
|
BLAKE2b-256 | 9283e83b4c3584a57bd0ff544b2923a8490f680143fe6b3c18fe778e7ac66af5 |