Advanced Google Tasks CLI

A powerful command-line tool for managing Google Tasks with enhanced features like deduplication, synchronization, reporting, and interactive task management.

gtasks-terminal
$ gtasks interactive
🚀 Entering interactive mode...
┌─────────────────────────────────────────────────────────────┐
│ Google Tasks CLI - Interactive Mode │
│ │
│ [1] 📋 View Tasks (12 pending, 3 completed) │
│ [2] ➕ Add New Task │
│ [3] 🔄 Sync with Google │
│ [4] 📊 Generate Report │
│ [5] 🏷️ Manage Tags │
│ [6] 👥 Switch Account (current: personal) │
│ │
│ [q] Quit │
└─────────────────────────────────────────────────────────────┘
Select option:

Powerful Features

Everything you need to manage your Google Tasks efficiently from the command line

Basic Task Management

Add, list, update, and delete tasks with a simple and intuitive command interface.

Advanced Filtering

Filter tasks by status, priority, tags, and date ranges with powerful query options.

Multi-Account Support

Manage tasks across multiple Google accounts seamlessly with easy switching.

Task Deduplication

Automatically identify and remove duplicate tasks to keep your lists clean.

Interactive Mode

Navigate tasks interactively with keyboard shortcuts in a rich terminal interface.

Reports Generation

Generate comprehensive analytical reports on task activities and productivity.

Quick Installation

Get started in minutes with PyPI installation

Install from PyPI (Recommended)

pip install gtasks-terminal

Prerequisites

  • Python 3.7 or higher
  • A Google account with Google Tasks enabled
  • Google Cloud Project with Tasks API enabled

Authentication Required: You'll need to set up OAuth 2.0 credentials. See the installation guide for detailed instructions.

Development Setup

# Clone the repository
git clone https://github.com/sirusdas/gtasks-terminal.git
cd gtasks-terminal

# Set up virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate

# Install dependencies
cd gtasks_cli
pip install -r requirements.txt

# Install in development mode
pip install -e .

Usage Examples

See gtasks-terminal in action

Basic Commands

# Enter interactive mode
gtasks interactive

# List all tasks
gtasks list

# Add a new task
gtasks add "Complete project report" --due tomorrow --priority high

# Sync with Google
gtasks advanced-sync

Advanced Filtering

# Filter by status and priority
gtasks list --status pending --priority high

# Filter by date range
gtasks list --filter this_week:due_date

# Search with regex
gtasks list --search "project|meeting"

# Combine filters
gtasks list --status pending --tags work --order-by due_date

Multi-Account Management

# Add a new account
gtasks account add --name work

# List all accounts
gtasks account list

# Switch account
gtasks account use work

# Use specific account for command
gtasks list --account work --status pending

Reports Generation

# Generate completion report
gtasks generate-report rp1 --days 30

# List available reports
gtasks generate-report --list

# Organized tasks report
gtasks generate-report rp9

# Export report
gtasks generate-report rp1 --format json --output report.json

Comprehensive Documentation

Everything you need to master gtasks-terminal

Security & Privacy First

Your data stays private. Always.

Zero Data Collection

We don't collect any personal data or usage statistics

Local Processing

All data processing happens on your machine

Secure Authentication

Industry-standard OAuth 2.0 with local token storage

Ready to Supercharge Your Task Management?

Join thousands of developers and productivity enthusiasts who trust gtasks-terminal for their Google Tasks management.