gtask-cli

Add and manage Google Tasks from the terminal.

---

Overview

gtask is a fast, keyboard-first command line tool for Google Tasks. Capture a task without leaving the terminal, and it syncs to the Google Tasks apps, home screen widgets, and Google Calendar. The OAuth scope is tasks only, so gtask can read and write tasks and nothing else: no Gmail, no Drive, no Calendar.

It is built to stay small, with the least friction between a thought and it being captured.

Features

• Add a task in one command with a terse, day first date format
• A default view of today and overdue tasks across all lists
• Complete, reopen, edit, or delete tasks by the number shown, never a raw id
• Multiple lists and subtasks, with move and clear support
• Tasks only OAuth scope, with the token cached locally
• JSON output and stable ids for scripting
• Built with Typer and Rich for a clean terminal experience

Getting started

Prerequisites

• Python 3.10 or newer
• A Google account that holds your tasks
• A one-time Google OAuth client, see the setup guide
• pipx, only if you use make install

Installation

Install gtask as a system wide command. Clone the repo, then use one of:

git clone git@github.com:thesouldev/gtask-cli.git
cd gtask-cli

make install      # installs and updates via pipx (needs pipx)
# or
./install.sh      # sets up a virtualenv and links gtask onto your PATH

make install is also how you update to the latest version after a git pull.

Confirm it is on your PATH:

gtask --help

Then complete the one-time setup and authorize:

gtask login

Development

For working on gtask itself, use the editable install with the dev tools (black, pylint, pytest):

make dev-install
make test

Usage

gtask add "email the client" 22        # due the 22nd of this month
gtask add "pay rent" 1-7 -l Personal   # 1 July, in the Personal list
gtask add "draft proposal"             # no due date
gtask ls                               # today and overdue across lists
gtask done 2                           # complete task #2 from the last ls

Full command reference is in the CLI reference.

Documentation

Full documentation lives at https://thesouldev.github.io/gtask-cli:

• Setup install, OAuth client, and login
• CLI reference every command and option

Contributing

Contributions are welcome. Open an issue to discuss substantial changes before sending a pull request.

License

This project is distributed under the GNU General Public License v3.0. See LICENSE for the full text.