Google任务命令行管理

技能简介

gtasks-cli 是一个命令行工具，用于直接管理 Google Tasks 中的任务清单和待办事项。无需打开浏览器或手机应用，通过终端即可完成查看、创建、更新、删除等全部操作。

能做什么

• 查看所有任务清单及其中任务
• 创建新的任务清单和具体任务
• 标记任务完成或恢复未完成状态
• 修改任务标题、描述、截止日期
• 删除任务清单或单个任务
• 按截止日期、标题等排序查看

使用说明

1. 安装 gtasks CLI

# 检查是否已安装
gtasks --version 2>/dev/null || echo "未安装"

# 未安装时：从 GitHub Releases 下载对应系统二进制文件
# macOS/Linux: 移动到 /usr/local/bin 或加入 PATH
# Windows: 加入 PATH 环境变量中的文件夹

2. 配置环境变量

export GTASKS_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GTASKS_CLIENT_SECRET="your-client-secret"

获取方式：Google Cloud Console → 启用 Google Tasks API → 创建 OAuth2 凭证（Web应用类型）→ 添加重定向 URI 包含 http://localhost:8080/callback 等端口

3. 登录认证

gtasks login

浏览器完成 OAuth2 授权，令牌保存在 ~/.gtasks/token.json

4. 常用命令

# 查看任务清单
gtasks tasklists view

# 创建任务清单
gtasks tasklists add -t "工作项目"

# 查看任务（默认表格格式）
gtasks tasks view
gtasks tasks view -l "工作项目" --sort=due

# 创建任务
gtasks tasks add -t "完成报告" --due "2024-12-25"

# 标记完成
gtasks tasks done

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管 GTASKS_CLIENT_ID 和 GTASKS_CLIENT_SECRET，避免泄露
• 认证令牌存储在本地 ~/.gtasks/token.json，注意文件权限
• 删除任务清单会同时删除其中所有任务，操作不可逆
• 依赖网络连接访问 Google Tasks API

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/bro3886/gtasks-cli/SKILL.md
来源类型：GitHub 开源技能仓库