Menu
Guide for AI agents to use tdo, Saku's GTD task manager. Use when helping manage tasks, projects, areas, and workflows.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | saku-integration |
| description | Guide for AI agents to use tdo, Saku's GTD task manager. Use when helping manage tasks, projects, areas, and workflows. |
| metadata | {"internal":false} |
Model: Area → Project → Task | Storage: ~/.local/share/tdo/store.json
tdo view today|inbox|upcoming|someday|logbook|trash|all|recurring|deadlines
tdo view area "name" # projects + tasks in area
tdo view project "name" # tasks in project
tdo view tag "name" # tasks with tag
tdo view task <id> # full detail of one task
tdo view ... --json # machine-readable output
tdo view ... --csv # CSV output
tdo view ... --watch # live-reload
tdo view ... --all # include completed tasks
Old
tdo today,tdo inboxetc. still work but are deprecated — usetdo view <sub>.tdo showis an alias fortdo view(same commands, kept for compatibility).
tdo add "Title" [SCHEDULE] [OPTIONS]
tdo move <id> [SCHEDULE] [OPTIONS] # update any field; can take multiple IDs
SCHEDULE (mutually exclusive): --today --tomorrow --next-week --someday --on DATE
OPTIONS: --due DATE -p PROJECT -a AREA -t TAG -n "notes" --every PATTERN --until DATE --parent <id>
tdo move extras: --clear-schedule --clear-deadline --clear-recurrence
tdo done <id> [<id>...] # complete task(s)
tdo done <id> --note "message" # complete with a note
tdo done <id> --stop # complete and stop recurring task from repeating
tdo delete <id> # soft-delete (move to trash)
tdo restore <id> # restore from trash
tdo depend <blocked-id> --on <blocker-id> # add dependency
tdo depend <blocked-id> --remove <blocker-id> # remove dependency
tdo add "Sub" --parent <parent-id> # create subtask
tdo create area "Name" # create area
tdo remove area "Name" # delete area (and all contents)
tdo create project "Name" [--area AREA] # create project
tdo done <slug> # complete project (via move command)
tdo remove project <slug> # delete project
tdo list areas|projects|tags
tdo edit area|project <name> --new-name "New"
Slugs are auto-generated: "My Project" →
my-project
tdo context # full situational snapshot (pretty)
tdo context --json # machine-readable snapshot
Shows: today summary, ready tasks, blocked tasks, overdue, recent completions, inbox count, active projects.
tdo completion bash|zsh|fish|powershell # generate shell completions
Natural: today tomorrow monday–sunday next-week next-monday
ISO (preferred): 2026-03-15
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Runtime error (task/project not found) |
| 2 | Validation error (conflicting flags, bad date) |
tdo remove is for areas/projects only — use tdo delete for taskstdo done 42 not tdo done "review")tdo list projects)| Tag | Meaning |
|---|---|
agent | Task assigned to an AI agent |
needs-review | Agent completed work, human review needed |
blocked-human | Agent cannot proceed, human input required |
tdo view today --tag agent --ready # agent's actionable tasks (excludes blocked)
tdo view inbox --tag agent --ready # agent inbox tasks
tdo view inbox --tag needs-review # tasks awaiting human review
tdo view today --tag blocked-human # tasks blocked on human input
Agent starting a session:
tdo context --json # full orientation snapshot
tdo view today --tag agent --ready --json # agent-specific actionable tasks
Agent completing work:
tdo done 42 --note "Implemented feature X, added tests"
tdo move 42 -t needs-review # flag for human review (before completing)
Human reviewing agent work:
tdo view inbox --tag needs-review
tdo done 42 --note "Reviewed and approved"
Agent blocked on human input:
tdo move 42 -t blocked-human --note "Need clarification on API design"