| name | agentio-gtasks |
| description | Use when interacting with Google Tasks via the agentio CLI. |
Gtasks via agentio
Auto-generated from agentio skill gtasks. Do not edit by hand.
agentio gtasks lists list
List all task lists
Options:
--profile <name>: Profile name (optional if only one profile exists)
--limit <n>: Max results (default: 100)
Examples:
# show all your task lists with IDs
agentio gtasks lists list
# cap at a smaller number
agentio gtasks lists list --limit 10
agentio gtasks lists create
Create a new task list
Options:
--profile <name>: Profile name (optional if only one profile exists)
Examples:
# create a new top-level task list
agentio gtasks lists create "Groceries"
# title with spaces (quote it)
agentio gtasks lists create "Q4 Roadmap"
agentio gtasks lists delete
Delete a task list
Options:
--profile <name>: Profile name (optional if only one profile exists)
Examples:
# delete a list (irreversible — deletes all its tasks)
agentio gtasks lists delete MTIzNDU2Nzg5MA
agentio gtasks list
List tasks in a task list
Options:
--profile <name>: Profile name (optional if only one profile exists)
--limit <n>: Max results (default: 20)
--show-completed: Include completed tasks (default: true)
--no-show-completed: Exclude completed tasks
--show-hidden: Include hidden tasks
--due-min <datetime>: Filter: due date minimum (RFC3339)
--due-max <datetime>: Filter: due date maximum (RFC3339)
Examples:
# tasks in a list (default: includes completed)
agentio gtasks list MTIzNDU2Nzg5MA
# only outstanding work
agentio gtasks list MTIzNDU2Nzg5MA --no-show-completed
# tasks due this week
agentio gtasks list MTIzNDU2Nzg5MA \
--due-min 2024-04-15T00:00:00Z --due-max 2024-04-22T00:00:00Z
# include hidden (cleared completed) tasks too
agentio gtasks list MTIzNDU2Nzg5MA --show-hidden
agentio gtasks get
Get a specific task
Options:
--profile <name>: Profile name (optional if only one profile exists)
Examples:
# full task details (notes, due, status, parent)
agentio gtasks get MTIzNDU2Nzg5MA NjU0MzIxMA
agentio gtasks add
Add a new task
Options:
--profile <name>: Profile name (optional if only one profile exists)
--title <title>: Task title
--notes <text>: Task notes/description (or pipe via stdin)
--due <date>: Due date (RFC3339 or YYYY-MM-DD)
--parent <task-id>: Parent task ID (create as subtask)
--previous <task-id>: Previous sibling task ID (controls ordering)
Examples:
# simple task
agentio gtasks add MTIzNDU2Nzg5MA --title "Buy milk"
# task with notes (piped from stdin) and a due date
echo "2 cartons, organic" | agentio gtasks add MTIzNDU2Nzg5MA --title "Buy milk" --due 2024-04-20
# subtask of an existing task
agentio gtasks add MTIzNDU2Nzg5MA --title "Section 1" --parent NjU0MzIxMA
# control ordering: place new task right after another
agentio gtasks add MTIzNDU2Nzg5MA --title "Step 2" --previous NjU0MzIxMA
agentio gtasks update
Update an existing task
Options:
--profile <name>: Profile name (optional if only one profile exists)
--title <title>: New title
--notes <text>: New notes (or pipe via stdin)
--due <date>: New due date (RFC3339 or YYYY-MM-DD, empty to clear)
--status <status>: New status: needsAction or completed
Examples:
# rename a task
agentio gtasks update MTIzNDU2Nzg5MA NjU0MzIxMA --title "Buy oat milk"
# change due date
agentio gtasks update MTIzNDU2Nzg5MA NjU0MzIxMA --due 2024-04-22
# replace notes from stdin
cat new-notes.txt | agentio gtasks update MTIzNDU2Nzg5MA NjU0MzIxMA
# mark complete via status
agentio gtasks update MTIzNDU2Nzg5MA NjU0MzIxMA --status completed
agentio gtasks done
Mark a task as completed
Options:
--profile <name>: Profile name (optional if only one profile exists)
Examples:
# mark a task complete
agentio gtasks done MTIzNDU2Nzg5MA NjU0MzIxMA
agentio gtasks undo
Mark a task as needs action (not completed)
Options:
--profile <name>: Profile name (optional if only one profile exists)
Examples:
# revert a task back to needs-action
agentio gtasks undo MTIzNDU2Nzg5MA NjU0MzIxMA
agentio gtasks delete
Delete a task
Options:
--profile <name>: Profile name (optional if only one profile exists)
Examples:
# remove a task entirely (irreversible)
agentio gtasks delete MTIzNDU2Nzg5MA NjU0MzIxMA
agentio gtasks clear
Clear all completed tasks from a task list
Options:
--profile <name>: Profile name (optional if only one profile exists)
Examples:
# hide all completed tasks from the list
agentio gtasks clear MTIzNDU2Nzg5MA
Cleared tasks remain accessible via 'gtasks list --show-hidden'.
agentio gtasks move
Move a task (change parent or position)
Options:
--profile <name>: Profile name (optional if only one profile exists)
--parent <task-id>: New parent task ID (make subtask)
--previous <task-id>: Previous sibling task ID (change position)
Examples:
# nest a task under another (make it a subtask)
agentio gtasks move MTIzNDU2Nzg5MA NjU0MzIxMA --parent ABCD1234EFGH
# reorder: place after a specific sibling
agentio gtasks move MTIzNDU2Nzg5MA NjU0MzIxMA --previous ABCD1234EFGH
# promote subtask + reorder in one call
agentio gtasks move MTIzNDU2Nzg5MA NjU0MzIxMA --parent NEWP4R3NTID --previous ABCD1234EFGH
At least one of --parent or --previous is required.