A powerful CLI tool for managing tasks in the todo.txt format with support for dependencies, recurrence, and advanced filtering.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install topydo
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install topydo using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is topydo Task Manager?
topydo is a comprehensive command-line interface designed to handle task management using the portable and human-readable todo.txt format. It goes beyond simple list-making by offering a sophisticated set of features including task dependencies, start dates, and complex recurrence patterns. This skill enables AI agents to interact with your personal organization system directly through Openclaw Skills, allowing for seamless task creation and maintenance across different platforms.
By utilizing topydo, users can maintain full control over their data while benefiting from advanced organizational logic. The skill excels at interpreting natural language task descriptions and converting them into structured todo.txt entries, ensuring that your workflow remains both flexible and highly organized within the ecosystem of Openclaw Skills.
topydo Task Manager Use Cases
- Managing complex project hierarchies using subtasks and dependencies within Openclaw Skills.
- Automating the creation of recurring maintenance tasks with strict or relative scheduling.
- Filtering and prioritizing large backlogs based on importance, due dates, or custom tags.
- Synchronizing task lists across macOS, Linux, and Windows environments using a unified plain-text format.
How topydo Task Manager Works
- The AI agent receives a task-related request and translates it into a topydo command.
- The skill parses the input to identify specific projects (+), contexts (@), and priorities (A-Z).
- Tasks are written to a local todo.txt file according to the configuration defined in your environment.
- Advanced queries like filtering by due date or sorting by importance are processed against the text-based database.
- Completed tasks are updated with a completion date and can be moved to an archive file to keep the main list performant.
topydo Task Manager Setup
To get started with topydo for Openclaw Skills, install the package using your preferred package manager:
# For macOS users
brew install topydo
# For all platforms via pip
pip3 install topydo
After installation, configure your task file locations in a ~/.topydo configuration file:
[topydo]
filename = ~/todo.txt
archive_filename = ~/done.txt
topydo Task Manager Data Schema & Taxonomy
The skill organizes data using the standard todo.txt convention supplemented by topydo-specific metadata tags. The structure is designed for maximum compatibility and clarity:
| Component | Format | Purpose |
|---|---|---|
| Priority | (A), (B), etc. | Defines task urgency at the start of the line |
| Dates | YYYY-MM-DD | Used for creation, completion, and due dates |
| Projects | +ProjectName | Groups related tasks together |
| Contexts | @ContextName | Identifies tools or locations required |
| Recurrence | rec:1w | Sets repeating intervals (e.g., weekly) |
| Dependencies | before:1 | Links tasks together in a logical sequence |
topydo Task Manager Advanced Features
- Support for business-day relative dates (e.g., 5b) for professional scheduling.
- Importance calculation engine that weighs priority, proximity to due dates, and star status.
- Visual dependency mapping using Graphviz integration for complex project management.
- Multi-command undo functionality via the revert system to prevent data loss.
- Customizable output formats including JSON for integration with other Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
pass - The Standard Unix Password Manager
A lightweight, terminal-based password manager that uses GPG encryption and a simple file-system hierarchy to secure your credentials.
Obsidian Daily Notes
A comprehensive CLI-based skill for managing Obsidian daily journals, tasks, and search queries within an AI agent workflow.
Conventional Commits
A skill that enforces the Conventional Commits specification for git messages to enable automated changelogs and semantic versioning.
Pet Sitter Client Intake Form Generator
A specialized tool for pet care professionals to generate branded, fillable PDF client intake and onboarding forms with ease.
EWS Calendar Sync for Microsoft Exchange
A secure tool for extracting structured meeting data from Microsoft Exchange via the EWS API.
AEO (Answer Engine Optimization) System
An advanced toolkit for Openclaw Skills to audit, map, and optimize brand visibility across AI answer engines like Perplexity and ChatGPT.
METADATA
Featured*
