Agent skill · writing content · sundial-org
topydo
Manage todo.txt tasks using topydo CLI. Add, list, complete, prioritize, tag, and organize tasks with dependencies, due dates, recurrence, and projects. Use for any task management, todo lists, or when the user mentions tasks, todos, or todo.txt. Requires Python 3 and pip. Works on macOS, Linux, and Windows.
Why this skill is useful
Provides specific commands and configurations for managing tasks with topydo that the AI wouldn't reliably generate on its own.
What it needs
Requires pip, python3 installed locally. About 4k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
topydo - Todo.txt Task Manager topydo is a powerful CLI for managing tasks in the todo.txt format. It supports dependencies, due dates, start dates, recurrence, priorities, projects, and contexts. Task Format Reference Installation Homebrew (macOS, preferred) pip (all platforms) With optional features: apt (Ubuntu/Debian) Configuration Config file locations (in order of precedence): topydo.conf or .topydo (current directory) ~/.topydo or ~/.config/topydo/config /etc/topydo.conf Example ~/.topydo: Adding Tasks Basic task: With priority (A is highest): With project and context: With due date (absolute): With due date (relative): With due date (weekday): With start/threshold date: With recurrence (weekly): With strict recurrence (always on 1st of month): With dependency (must complete before task 1): As subtask of task 1: Listing Tasks List all relevant tasks: Include hidden/blocked tasks: Filter by project: Filter by context: Filter by priority: Filter by priority range: Filter tasks due today: Filter overdue tasks: Filter tasks due by Friday: Combine multiple filters: Exclude context: Sort by priority: Sort descending by due date, then priority: Group by project: Limit to 5 results: Custom output format: Output as JSON: Completing Tasks Complete task by ID: Complete multiple tasks: Complete all tasks due today: Complete with custom date: Priority Management Set priority A: Set priority for multiple tasks: Remove priority: Tagging Tasks Set due date: Star a task: Remove a tag: Set custom tag with relative date: Modifying Tasks Append text to task: Append due date: Edit task in text editor: Edit all tasks in project: Deleting Tasks Delete by ID: Delete multiple: Delete by expression: Dependencies Add dependency (task 2 depends on task 1): Task 2 is part of task 1: List what depends on task 1: List what task 1 depends on: Remove dependency: Visualize dependencies (requires graphviz): Postponing Tasks Postpone by 1 week: Postpone by 3 days: Postpone including start date: …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/topydo