ggltasks - Google Tasks TUI

A lightning-fast, robust TUI for Google Tasks, built for terminal power users.

Features

• Async UI: Network requests are threaded. The app boots instantly and never freezes.
• Native Sync: Moves, completions, and deletions flawlessly sync with the official Google backend.
• Smart Timestamps: Due dates and "Last Updated" timestamps.
• Vim Navigation: Navigate entirely using h/j/k/l.

Screenshots

Installation

Google requires you to generate a personal "Client Secret" to access your data securely.

Step 1: Get Google API Credentials

1. Go to the Google Cloud Console.
2. Create a New Project (e.g., ggltasks-cli).
3. Search for Google Tasks API and click Enable.
4. Go to APIs & Services → Credentials.
5. Click + CREATE CREDENTIALS → OAuth client ID. (Choose "Desktop app" as the Application type).
6. You may need to configure the OAuth consent screen first — just set it to "External" and add your Google account as a test user.
7. Download the JSON file and rename it exactly to client_secrets.json.

Step 2: Install and Run

1. Install via pip:

   pip install ggltasks
   

2. Run the app:

   ggltasks
   

3. The app will automatically create the .ggltasks config folder in your home directory and give you instructions on where to place your client_secrets.json file.
4. Move your client_secrets.json file into that folder and run ggltasks again!

Note: The first time it successfully connects, a browser window will pop up asking you to log in to your Google Account. A local token is saved so you only have to do this once.

Usage

Task Status Symbols

• [ ] : Pending
• [X] : Completed
• * : Has text Note
• (N) : Number of direct subtasks
• [Upd: MM-DD HH:MM] : Local time the task was last updated

Known Limitations (Google Tasks API)

These are inherent limitations of the official Google Tasks API backend, not this app:

• No Times on Due Dates: The API strips specific hours/minutes off due dates, forcing them to midnight UTC. You can assign a day, but not a time.
• No Recurring Tasks: The API does not allow 3rd party apps to create or manage recurring/repeating tasks.
• Subtask Display Limits: The API allows infinitely deep subtasks (and this CLI app fully supports them). However, Google's official web/mobile apps will only display 1 level deep.

License

MIT License.