A command-line task management integration utilizing the todo.txt format to organize projects, priorities, and contexts directly through an AI agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install todo-txt-skill
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 todo-txt-skill 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 Todo.txt Task Manager?
The Todo.txt Task Manager skill enables developers and power users to interact seamlessly with their task lists using the popular todo.sh CLI engine. By processing plain-text files into highly structured data lists, this skill allows an AI agent to handle the creation, organization, prioritization, and completion of your daily responsibilities.
As part of the expanding ecosystem of Openclaw Skills, this tool provides an efficient mechanism for automating personal productivity. Whether managing software development milestones or organizing daily errands, the integration automatically parses priority levels, custom contexts, and project tracking tags natively without leaving your workspace.
Todo.txt Task Manager Use Cases
- Tracking and updating software bugs, personal errands, or team deadlines directly from an agent prompt.
- Organizing complex workflows into distinct project lists using + tags and specific contexts using @ tags.
- Automating routine command-line task maintenance like deduplicating, archiving completed tasks, and running progress reports.
- Filtering down massive backlogs by prioritizing items with strict alphabetical urgency tags (A-Z).
How Todo.txt Task Manager Works
- The AI agent parses the user's intent to extract tasks, projects, and contexts.
- The skill executes the associated todo.sh CLI utility commands on the host machine.
- If the utility is not found, the agent runs a secure system installer to configure todo.sh and its configuration paths.
- Commands are structured using precise flags to bypass interactive prompts and automate actions smoothly.
- The system automatically lists the updated index after any modification to ensure real-time accuracy.
Todo.txt Task Manager Setup
Installation
This skill features a bundled installer script that configures the todo.sh CLI automatically. It detects your operating system and handles dependencies safely:
bash scripts/install_todo_cli.sh
Manual Installation
If the automated script is bypassed or fails, follow these manual setup instructions:
macOS (via Homebrew):
brew install todo-txt
cp -n $(brew --prefix)/opt/todo-txt/todo.cfg ~/.todo.cfg
Linux (from source):
git clone https://github.com/todotxt/todo.txt-cli.git
cd todo.txt-cli
make
sudo make install
cp -n /usr/local/etc/todo/config ~/.todo/config
Verify Configuration:
todo.sh -V
Todo.txt Task Manager Data Schema & Taxonomy
The todo.txt specification is structured as a standard, human-readable plain text schema. Every entry is organized on a single line following this syntax schema:
| Element | Syntax Pattern | Example |
|---|---|---|
| Priority | (A-Z) prefix at start |
(A) |
| Completion State | x prefix followed by date |
x 2026-12-10 |
| Creation Date | YYYY-MM-DD |
2026-12-01 |
| Project Tags | +projectname |
+webdevelopment |
| Context Tags | @contextname |
@computer |
| Metadata Pairs | key:value |
due:2026-12-31 |
Output Format Example
(A) Call client @phone +sales due:2026-12-15
x 2026-12-10 2026-12-01 Review database backup +devops @server
Todo.txt Task Manager Advanced Features
- Auto-Archiving: Automatically shifts completed tasks from the active roster into a dedicated done.txt archive file.
- Batch Task Processing: Add multiple tasks at once using the
addmutility block or complete multiple task IDs in a single operational loop. - Deduplication Engine: Clean up plain-text task lists by purging duplicate entries automatically.
- Automated Timestamping: Use the
-toption flag to automatically append the current calendar date to newly generated records.
SKILL.md
Loading
Related Openclaw Skills
Special
The Special skill is a read-only architecture discovery tool that analyzes your repository's existing codebase to propose concrete, high-leverage feature roadmaps and opportunities.
Image Analyzer Advisor
An AI-driven image analysis skill designed to inspect visual elements, composition, and quality to provide actionable recommendations.
MiniMax TTS AI Voice Synthesis
A command-line tool and integration script that synthesizes ultra-realistic, multilingual text-to-speech using the high-performance MiniMax HTTP REST API.
URL Bookmarker
URL Bookmarker is a developer-friendly command-line skill that enables local-first bookmark management, tagging, full-text searching, and flexible file exporting.
stations
A sophisticated fan-out skill that coordinates concurrent AI subagents by clustering independent tasks, drafting complete tickets, and conducting final integrations.
skillify
A utility designed to capture manual workflows, transcripts, and command patterns, converting them into discoverable, highly effective agent skills.
Featured*
