Note

EvanEdwards is a fork to add functionality and bring it up to date with Google's specs

• json output
  • help for json output
• Update credential fetch to match Google's newer spec
• Delete and toggle completed by task ID
• Move credential storage to XDG specs (.config/gtasks/{files}.json)
• Add manpage
• Add jday Obsidian scripts to sync Obsidian with Google Tasks
• Make the docs site live again.
  • Update the docs site
  • Split the docs site to a different repo?

Google Tasks CLI

gtasks: A CLI Tool for Google Tasks

---

Docs

Refer to the docs website to read about available commands.

Instructions to install

(make sure $HOME/go/bin is added to $PATH

go install github.com/BRO3886/gtasks@latest

or you can download the binary:

1. Download the binary for your system (check releases)
2. Move to a particular folder, for eg Documents
3. Append the absolute path (use pwd) of the folder to PATH
4. Execute gtasks from anywhere

Instructions to Run and Build from Source:

• Pre-requisites
  • Go
• Directions to install

git clone https://github.com/BRO3886/google-tasks-cli

• Directions to execute

(if you're on linux)

make linux
./bin/linux/gtasks <COMMAND>

(if you're on windows)

make windows
./bin/windows/gtasks <COMMAND>

Or, you can check out the pre-compiled binaries under Releases

• Usage

Usage:
  gtasks [command]

Available Commands:
  help        Help about any command
  login       Logging into Google Tasks
  tasklists   View and create tasklists for currently signed-in account
  tasks       View, create, list and delete tasks in a tasklist

Flags:
  -h, --help     help for gtasks
  -t, --toggle   Help message for toggle

Use "gtasks [command] --help" for more information about a command.

Commands

Help

• To see details about a command

gtasks <COMMAND> help

Auth

• Login

gtasks login

• Logout

gtasks logout

Tasklists

• Viewing Tasklists

gtasks tasklists view

• Creating a Tasklist

gtasks tasklists add -t 'title'
gtasks tasklists add --title 'title'

• Deleting a Tasklist

gtasks tasklists rm

Tasks

• To pre-select tasklist, provide it's title as follows:

gtasks tasks -l <title> subcommand [--subcommand-flags]

Examples:

gtasks tasks [--tasklist|-l] "DSC VIT" view [--include-completed | -i]

Note: If the -l flag is not provided you will be able to choose a tasklist from the prompt

• Viewing tasks

gtasks tasks view

• Include completed tasks

gtasks tasks view -i
gtasks tasks view --include-completed

• Sort options

gtasks tasks view ... --sort [due,title,position, default=position]

• Adding a task

gtasks tasks add

• Mark task as completed

gtasks tasks done

• Deleting a task

gtasks tasks rm

Made with ☕ & Cobra