topydo

Manage todo.txt tasks via the topydo command-line interface.

6|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/bastos/skills --skill topydo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: topydo
Source: https://github.com/bastos/skills/tree/main/topydo
Command: npx skills add https://github.com/bastos/skills --skill topydo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Topydo provides a robust command-line interface to manage todo.txt tasks, simplifying creation, organization, and tracking of tasks across projects, contexts, and due dates.

Core Features & Use Cases

  • Create, list, complete, prioritize, tag, and schedule tasks using a concise CLI.
  • Support for projects (+Project) and contexts (@Context), due dates, and recurrence with flexible editing and dependencies.
  • Use case: a developer keeps a clean, synchronized todo list across devices and teams via plain text files.

Quick Start

Add a new task with a short description, then list tasks to see it in your queue and mark it complete when done.

Frequently Asked Questions about topydo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage todo.txt tasks via the command line?

You can manage todo.txt tasks via the command line by using topydo to add, list, complete, tag, and prioritize items. It processes deterministic task operations directly from your terminal.

Can I schedule recurring tasks and due dates in a plain text todo list?

Yes, you can schedule recurring tasks and due dates in a plain text todo list. Topydo supports flexible editing for due dates and recurrence patterns alongside projects and contexts.

Do I need Python to run a CLI todo.txt manager?

Yes, you need Python 3 and pip installed to run this CLI todo.txt manager. The topydo CLI relies on the Python environment to execute its task operations.

What is the best way to organize tasks with projects and contexts in todo.txt?

The best way to organize tasks with projects and contexts in todo.txt is using a CLI like topydo. It natively parses +Project and @Context tags to group and filter your task queue.

How do I add and complete tasks using topydo?

You add and complete tasks using topydo by passing concise CLI commands to create a new item with a description, then marking it complete when done to remove it from your queue.

Are there limitations to managing tasks with a plain text file CLI?

A limitation of managing tasks with a plain text file CLI is that synchronization across devices and teams relies on external file syncing, as topydo only performs local deterministic task operations.