@tjboudreaux/gtcli 0.1.0

package/README.md

@@ -0,0 +1,158 @@
+# gtcli - Google Tasks CLI
+
+[![CI](https://github.com/tjboudreaux/gtcli/actions/workflows/ci.yml/badge.svg)](https://github.com/tjboudreaux/gtcli/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/%40tjboudreaux%2Fgtcli.svg)](https://www.npmjs.com/package/@tjboudreaux/gtcli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A fast, minimal command-line interface for Google Tasks. Manage your task lists and tasks directly from the terminal with simple, intuitive commands.
+
+## Features
+
+- **Multi-account support** - Manage tasks across multiple Google accounts
+- **Full CRUD operations** - Create, read, update, delete tasks and task lists
+- **Subtasks** - Create hierarchical task structures with parent-child relationships
+- **Tab-separated output** - Easy to parse with standard Unix tools
+- **Secure OAuth2** - Browser-based or manual authentication flow
+- **Cross-platform** - Works on macOS, Linux, and Windows
+
+## Install
+
+```bash
+npm install -g @tjboudreaux/gtcli
+```
+
+## Setup
+
+Before using gtcli, you need OAuth2 credentials from Google Cloud Console:
+
+1. [Create a new project](https://console.cloud.google.com/projectcreate) (or select existing)
+2. Enable the [Google Tasks API](https://console.cloud.google.com/apis/api/tasks.googleapis.com)
+3. [Set app name](https://console.cloud.google.com/auth/branding) in OAuth branding
+4. [Add test users](https://console.cloud.google.com/auth/audience) (all Google accounts you want to use)
+5. [Create OAuth client](https://console.cloud.google.com/auth/clients):
+   - Click "Create Client"
+   - Application type: "Desktop app"
+   - Download the JSON file
+
+Then configure gtcli:
+
+```bash
+gtcli accounts credentials ~/path/to/credentials.json
+gtcli accounts add you@gmail.com
+```
+
+## Usage
+
+```
+gtcli accounts <action>                    Account management
+gtcli <email> lists [command] [options]    Task list operations
+gtcli <email> tasks <listId> [command]     Task operations
+```
+
+## Commands
+
+### accounts
+
+```bash
+gtcli accounts credentials <file.json>   # Set OAuth credentials (once)
+gtcli accounts list                      # List configured accounts
+gtcli accounts add <email>               # Add account (opens browser)
+gtcli accounts add <email> --manual      # Add account (browserless, paste redirect URL)
+gtcli accounts remove <email>            # Remove account
+```
+
+### lists
+
+```bash
+# List all task lists
+gtcli <email> lists [--max N] [--page TOKEN]
+
+# Task list operations
+gtcli <email> lists get <listId>
+gtcli <email> lists create <title>
+gtcli <email> lists update <listId> --title <title>
+gtcli <email> lists delete <listId>
+gtcli <email> lists url <listIds...>
+```
+
+### tasks
+
+```bash
+# List tasks in a task list
+gtcli <email> tasks <listId> [--completed] [--hidden] [--max N]
+
+# Task operations
+gtcli <email> tasks <listId> get <taskId>
+gtcli <email> tasks <listId> create <title> [--notes N] [--due DATE] [--parent ID]
+gtcli <email> tasks <listId> update <taskId> [--title T] [--notes N] [--due DATE] [--status STATUS]
+gtcli <email> tasks <listId> complete <taskId>
+gtcli <email> tasks <listId> uncomplete <taskId>
+gtcli <email> tasks <listId> delete <taskId>
+gtcli <email> tasks <listId> move <taskId> [--parent ID] [--previous ID]
+gtcli <email> tasks <listId> clear
+gtcli <email> tasks <listId> url <taskIds...>
+```
+
+**Status options:** `needsAction`, `completed`
+
+**Due date format:** RFC 3339 timestamp (e.g., `2024-12-31T00:00:00Z`)
+
+## Examples
+
+```bash
+# List all task lists
+gtcli you@gmail.com lists
+
+# Create a new task list
+gtcli you@gmail.com lists create "Shopping List"
+
+# List tasks in default task list (use list ID from 'lists' command)
+gtcli you@gmail.com tasks MTIzNDU2Nzg5
+
+# Create a task with due date
+gtcli you@gmail.com tasks MTIzNDU2Nzg5 create "Buy groceries" --due "2024-12-31T00:00:00Z"
+
+# Create a task with notes
+gtcli you@gmail.com tasks MTIzNDU2Nzg5 create "Call mom" --notes "Ask about dinner plans"
+
+# Mark task as completed
+gtcli you@gmail.com tasks MTIzNDU2Nzg5 complete TASK_ID
+
+# List completed tasks
+gtcli you@gmail.com tasks MTIzNDU2Nzg5 --completed
+
+# Clear all completed tasks
+gtcli you@gmail.com tasks MTIzNDU2Nzg5 clear
+
+# Create a subtask
+gtcli you@gmail.com tasks MTIzNDU2Nzg5 create "Buy milk" --parent PARENT_TASK_ID
+
+# Move task to different position
+gtcli you@gmail.com tasks MTIzNDU2Nzg5 move TASK_ID --previous SIBLING_TASK_ID
+```
+
+## Data Storage
+
+All data is stored in `~/.gtcli/`:
+
+- `credentials.json` - OAuth client credentials
+- `accounts.json` - Account tokens
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run check
+npm test
+```
+
+## Acknowledgements
+
+Inspired by:
+- [gmcli](https://github.com/badlogic/gmcli) - Gmail CLI by badlogic
+- [gdcli](https://github.com/tjboudreaux/gdcli) - Google Drive CLI
+
+## License
+
+MIT

package/dist/account-storage.d.ts

@@ -0,0 +1,21 @@
+import type { Account, StoredCredentials } from "./types.js";
+export declare class AccountStorage {
+    private accounts;
+    private configDir;
+    private accountsFile;
+    private credentialsFile;
+    constructor(configDir?: string);
+    private ensureConfigDir;
+    private loadAccounts;
+    private isValidAccount;
+    private saveAccounts;
+    addAccount(account: Account): void;
+    getAccount(email: string): Account | undefined;
+    getAllAccounts(): Account[];
+    deleteAccount(email: string): boolean;
+    hasAccount(email: string): boolean;
+    setCredentials(clientId: string, clientSecret: string): void;
+    getCredentials(): StoredCredentials | null;
+    getConfigDir(): string;
+}
+//# sourceMappingURL=account-storage.d.ts.map

package/dist/account-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-storage.d.ts","sourceRoot":"","sources":["../src/account-storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE7D,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;gBAEpB,SAAS,CAAC,EAAE,MAAM;IAQ9B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,YAAY;IAIpB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKlC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI9C,cAAc,IAAI,OAAO,EAAE;IAI3B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQrC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI5D,cAAc,IAAI,iBAAiB,GAAG,IAAI;IAe1C,YAAY,IAAI,MAAM;CAGtB"}

package/dist/account-storage.js

@@ -0,0 +1,96 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+export class AccountStorage {
+    accounts = new Map();
+    configDir;
+    accountsFile;
+    credentialsFile;
+    constructor(configDir) {
+        this.configDir = configDir ?? path.join(os.homedir(), ".gtcli");
+        this.accountsFile = path.join(this.configDir, "accounts.json");
+        this.credentialsFile = path.join(this.configDir, "credentials.json");
+        this.ensureConfigDir();
+        this.loadAccounts();
+    }
+    ensureConfigDir() {
+        if (!fs.existsSync(this.configDir)) {
+            fs.mkdirSync(this.configDir, { recursive: true });
+        }
+    }
+    loadAccounts() {
+        if (fs.existsSync(this.accountsFile)) {
+            try {
+                const data = JSON.parse(fs.readFileSync(this.accountsFile, "utf8"));
+                if (Array.isArray(data)) {
+                    for (const account of data) {
+                        if (this.isValidAccount(account)) {
+                            this.accounts.set(account.email, account);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Ignore invalid JSON
+            }
+        }
+    }
+    isValidAccount(account) {
+        if (typeof account !== "object" || account === null)
+            return false;
+        const acc = account;
+        if (typeof acc.email !== "string")
+            return false;
+        if (typeof acc.oauth2 !== "object" || acc.oauth2 === null)
+            return false;
+        const oauth2 = acc.oauth2;
+        return (typeof oauth2.clientId === "string" &&
+            typeof oauth2.clientSecret === "string" &&
+            typeof oauth2.refreshToken === "string");
+    }
+    saveAccounts() {
+        fs.writeFileSync(this.accountsFile, JSON.stringify(Array.from(this.accounts.values()), null, 2));
+    }
+    addAccount(account) {
+        this.accounts.set(account.email, account);
+        this.saveAccounts();
+    }
+    getAccount(email) {
+        return this.accounts.get(email);
+    }
+    getAllAccounts() {
+        return Array.from(this.accounts.values());
+    }
+    deleteAccount(email) {
+        const deleted = this.accounts.delete(email);
+        if (deleted) {
+            this.saveAccounts();
+        }
+        return deleted;
+    }
+    hasAccount(email) {
+        return this.accounts.has(email);
+    }
+    setCredentials(clientId, clientSecret) {
+        fs.writeFileSync(this.credentialsFile, JSON.stringify({ clientId, clientSecret }, null, 2));
+    }
+    getCredentials() {
+        if (!fs.existsSync(this.credentialsFile)) {
+            return null;
+        }
+        try {
+            const data = JSON.parse(fs.readFileSync(this.credentialsFile, "utf8"));
+            if (typeof data.clientId === "string" && typeof data.clientSecret === "string") {
+                return data;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getConfigDir() {
+        return this.configDir;
+    }
+}
+//# sourceMappingURL=account-storage.js.map

package/dist/account-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-storage.js","sourceRoot":"","sources":["../src/account-storage.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}