mcpField
T
todo-tracker

todo-tracker

github.com/sundial-orgProductivity670176 installsUpdated 34w ago
Repository

About todo-tracker

TODO Tracker maintains a persistent TODO.md scratch pad in a workspace. It is for users who need to add, prioritize, complete, remove, and review tasks, including stale-item checks during heartbeat.

Key features

  1. 01Stores tasks in TODO.md
  2. 02Adds tasks with priority levels
  3. 03Marks tasks done or removes them
  4. 04Lists tasks by priority
  5. 05Checks stale tasks on heartbeat

Use cases

  1. 01Keeping a persistent workspace task list
  2. 02Reviewing high-priority tasks
  3. 03Tracking tasks that have gone stale

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill todo-tracker

After installing, type/todo-trackerin Claude Code to confirm it loaded.

Bundled filesREADME.mdscripts/todo.sh

Details

From the project README

TODO Tracker

Maintain a persistent TODO.md scratch pad in the workspace.

File Location

TODO.md in workspace root (e.g., /Users/nuthome/nuri-bot/TODO.md)

Commands

View TODO

When user asks: "what's on the TODO?", "show TODO", "pending tasks?"

cat TODO.md

Then summarize the items by priority.

Add Item

When user says: "add X to TODO", "TODO: X", "remember to X"

bash skills/todo-tracker/scripts/todo.sh add "<priority>" "<item>"

Priorities: high, medium, low (default: medium)

Examples:

bash skills/todo-tracker/scripts/todo.sh add high "Ingest low-code docs"
bash skills/todo-tracker/scripts/todo.sh add medium "Set up Zendesk escalation"
bash skills/todo-tracker/scripts/todo.sh add low "Add user memory feature"
Mark Done

When user says: "mark X done", "completed X", "finished X"

bash skills/todo-tracker/scripts/todo.sh done "<item-pattern>"

Matches partial text. Moves item to ✅ Done section with date.

Remove Item

When user says: "remove X from TODO", "delete X from TODO"

bash skills/todo-tracker/scripts/todo.sh remove "<item-pattern>"
List by Priority
bash skills/todo-tracker/scripts/todo.sh list high
bash skills/todo-tracker/scripts/todo.sh list medium
bash skills/todo-tracker/scripts/todo.sh list low

Heartbeat Integration

On heartbeat, check TODO.md:

  1. Count high-priority items
  2. Check for stale items (added >7 days ago)
  3. If items exist, include brief summary in heartbeat response

Example heartbeat check:

bash skills/todo-tracker/scripts/todo.sh summary

TODO.md Format

# TODO - Nuri Scratch Pad

*Last updated: 2026-01-17*

## 🔴 High Priority
- [ ] Item one (added: 2026-01-17)
- [ ] Item two (added: 2026-01-15) ⚠️ STALE

## 🟡 Medium Priority
- [ ] Item three (added: 2026-01-17)

## 🟢 Nice to Have
- [ ] Item four (added: 2026-01-17)

## ✅ Done
- [x] Completed item (done: 2026-01-17)

Response Format

When showing TODO:

📋 **TODO List** (3 items)

🔴 **High Priority** (1)
• Ingest low-code docs

🟡 **Medium Priority** (1)  
• Zendesk escalation from Discord

🟢 **Nice to Have** (1)
• User conversation memory

⚠️ 1 item is stale (>7 days old)

Comments

Markdown supported