TODO Tracker for Openclaw

A persistent markdown-based scratch pad for tracking and prioritizing tasks across AI agent sessions.

thiagoruss0
v1.0.0
Feb 7, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install todo-tracker1

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install todo-tracker1 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 Tracker?

The TODO Tracker is a robust utility designed to maintain a persistent TODO.md scratch pad directly within your workspace root. It serves as a reliable memory layer for AI agents, allowing them to record, prioritize, and archive tasks without losing context between different interactions or sessions. By integrating seamlessly into the workspace, it ensures that project goals and pending items are always accessible and actionable.

As one of the specialized Openclaw Skills, this tool provides a structured way to handle task lifecycle management. It includes built-in priority levels and automated tracking for stale items, ensuring that no critical task is forgotten. Whether you are managing complex coding workflows or simple reminders, this skill keeps your project trajectory organized and visible.

TODO Tracker Use Cases

  • Tracking pending development tasks and bug fixes during long coding sessions.
  • Organizing project goals into High, Medium, and Low priority tiers for better focus.
  • Automatically surfacing forgotten or stale tasks that have been untouched for over seven days.
  • Creating a historical record of completed work in a dedicated Done section.

How TODO Tracker Works

  1. The skill detects specific intent from user prompts such as "add to TODO" or "what's on my list."
  2. It interfaces with a localized TODO.md file in the root directory to ensure data persistence across sessions.
  3. Commands are routed through a dedicated shell script that handles sorting, timestamping, and priority management.
  4. Completed tasks are automatically moved to an archive section with a completion date for auditability.
  5. A background heartbeat process periodically scans the file to generate summaries and alert the user of high-priority or aging items.

TODO Tracker Setup

Before using this skill, ensure that OpenClawCLI is installed. You can then interact with the tracker using the following bash commands:

# To add a new high-priority task
bash skills/todo-tracker/scripts/todo.sh add "high" "Your task description"

# To mark a task as completed
bash skills/todo-tracker/scripts/todo.sh done "task-keyword"

# To view the current status
cat TODO.md

TODO Tracker Data Schema & Taxonomy

The skill organizes data within a TODO.md file using a specific markdown taxonomy:

Section Description
## High Priority Critical tasks requiring immediate attention, marked with a red indicator.
## Medium Priority Standard tasks that form the core of the current workflow.
## Nice to Have Low priority items and future considerations.
## Done An archive of completed tasks including completion timestamps.
Metadata Each item includes an added: YYYY-MM-DD tag for lifecycle tracking.

TODO Tracker Advanced Features

  • Stale item detection: Automatically identifies tasks older than 7 days and flags them with a warning.
  • Heartbeat integration: Proactively reminds the user of pending items during periodic system checks.
  • Pattern matching: Allows users to mark tasks as done using partial text matching rather than full descriptions.
  • Automated summaries: Generates prioritized reports of all active tasks, categorized by urgency.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*