A tiny todoist CLI program. Takes simple input and dumps it in your inbox or another project. Takes advantage of natural language processing to assign due dates, tags, etc.
- Tod - Table of Contents - Installation - Crates.io (Linux, Mac, and Windows) - AUR (Arch-based Linux) - GitHub (Linux, Mac, and Windows) - Usage - Discovering the commands - Usage Examples - Shell script examples - Sort, schedule, prioritize, and process tasks - How task priority is determined - Disabling spinners - Why I made this - Related projects - Contributing
Will ask for your Todoist API token on the first run, and your data in JSON format in $XDG_CONFIG_HOME/tod.cfg. This defaults to:
~/.config/tod.cfg on Linux~/Library/Application Support/tod.cfg on Mac```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh ```
Install Tod
bash
cargo install tod
```bash
yay tod-bin ```
Clone the project
bash
git clone git@github.com:alanvardy/tod.git
cd tod
./test.sh # run the tests
cargo build --release
You can then find the binary in /target/release/
```bash
tod -h
A tiny unofficial Todoist client
Usage: tod [OPTIONS] [COMMAND]
Commands:
task
project
version
help Print this message or the help of the given subcommand(s)
Options:
-o, --config
And also use it to dig into subcommands
```bash
tod task -h
Usage: tod task
Commands: create Create a new task list List all tasks in a project next Get the next task by priority complete Complete the last task fetched with the next command help Print this message or the help of the given subcommand(s)
Options: -h, --help Print help -V, --version Print version
```
```bash
tod -q Buy more milk today
tod task create
tod task create --content "Write more rust" --project code
tod project import
tod task next
tod project process
tod task complete && tod task next
tod tasks list --scheduled --project work
tod tasks list --project work ```
bash
echo "" && \
echo "=== EMPTYING INBOX ===" && \
tod project empty --project inbox && \
echo "" && \
echo "=== SCHEDULING DIGITAL ===" && \
tod project schedule --project digital && \
echo "" && \
echo "=== SCHEDULING PHYSICAL ===" && \
tod project schedule --project physical && \
echo "" && \
echo "=== PRIORITIZING DIGITAL ===" && \
tod project prioritize --project digital && \
echo "" && \
echo "=== PRIORITIZING PHYSICAL ===" && \
tod project prioritize --project physical
echo "" && \
echo "=== PROCESSING DIGITAL ===" && \
tod project process --project digital && \
echo "" && \
echo "=== PROCESSING PHYSICAL ===" && \
tod project process --project physical;
bash
tod version check || cargo install tod --force
Tasks are ranked by points and the first is returned, the points are the sum of the following:
Find the line in your tod.cfg that reads "spinners": null and change the value to false.
I am a developer who uses Todoist to reduce stress and cognitive overhead, by delegating things that a machine does well to a machine. This CLI application scratches some very specific itches for me, and I hope that it may be of use to others as well!
Some points around my general strategy:
tod project process)tod project empty, schedule, and prioritize)Contributions are welcome, just please open up an issue before putting too much work into a PR.