rChore

A feature packed unofficial Google Tasks CLI to boost your producitvity, written purely in Rust.

🤔 What is rChore?

rChore is an unofficial Google Tasks CLI, it can help you manage various tasks right from your terminal, it also comes with a powerlevel10k battery support to boost your producivity!

Primary features of rChore are:

Single command login and logout
Auto obtain access token, login only once!
Create, Check, Update and Delete your tasks
Switch between task-lists and ability to create, update, and, delete task-lists.
p10k battery support that boosts your productivity!

💻 Usage

After installing the binary, you can run it from anywhere by typing rchore
To get started with rChore, you need to login first, you can do this by typing rchore google login
A link will be prompt, copy it and open it in your browser, you will be redirected to Google login page.
You can then use the various commands to manage your tasks, for example rchore tasks list, rchore tasks add, rchore tasks done <task index>, rchore tasks delete <task index>
you can pass the -h flag to know more about a command, feel free to open an issue if you have any questions.

Powerlevel10k battery support

⬇ Installation

Cargo

If you have cargo installed, you can install rChore using cargo.

Few secret keys should be set via environment variables. To obtain GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET follow to: https://developers.google.com/tasks/firstapp#register. To set these variables you should add the following snippets (using your values for vars) to your ~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish

bash / zsh:

export GOOGLE_CLIENT_ID=xxx
export GOOGLE_CLIENT_SECRET=yyy

fish:

set -gx GOOGLE_CLIENT_ID xxx
set -gx GOOGLE_CLIENT_SECRET yyy

Run . ~/.bashrc / . ~/.zshrc / source ~/.config/fish/config.fish or restart your terminal emulator.
Run following install command.

cargo install rchore

Manual Installation

You can also download the binary and install it manually.

Go to releases page and grab the latest release of rChore.
Download the latest release of rChore specific to your OS.
If you are on Linux/MacOS, make sure you move the binary to somewhere in your $PATH (e.g. /usr/local/bin).

Powerlevel10k Battery Support

If you use powerlevel10k, you can type rchore battery to get help on installing the battery.

Open .p10k.zsh file in your favorite editor.
Copy the function from rchore battery and append it to your .p10k.zsh file

Add rchore to either POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS or POWERLEVEL9K_LEFT_PROMPT_ELEMENTS

  typeset -g POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS=(
  # =========================[ Line #1 ]=========================
  ...
  rchore
)

🛠 Architecture and Structure

⭐ Show your support

Give a ⭐ if you liked this project!

Spread the word to your fellows to boost producitivity for everyone!

🤝 Contributions

Feel Free to Open a PR/Issue for any feature or bug(s).
Make sure you follow the community guidelines and read CONTRIBUTING.md.md!
Feel free to open an issue to ask a question/discuss anything about rChore.
Have a feature request? Open an Issue!

⚖ License

Licensed under MIT License : https://opensource.org/licenses/MIT

Made with ❤ and multiple cups of coffee

janekx21/rchore