Pulse TODO for Openclaw

A centralized task management and scheduling system that ensures AI agents never miss a commitment or recurring responsibility.

kagura-agent
v0.3.0
Mar 31, 2026
0
766
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install pulse-todo

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 pulse-todo 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 Pulse TODO?

Pulse TODO provides a single source of truth for an AI agent's pending work, organizing everything from one-off tasks to complex recurring schedules. By utilizing Openclaw Skills to maintain a workspace-root TODO.md, agents can bridge the gap between human requests and autonomous execution. This framework eliminates the reliance on short-term model memory, replacing it with a robust system of record that integrates directly with cron jobs for reliable long-term scheduling.

The skill is designed around the core principle that everything is a task, differentiated only by its timing and dependencies. It allows agents to intelligently choose what to work on next by aligning task selection with strategic goals defined in documents like SOUL.md or MEMORY.md, ensuring that the agent remains productive during idle moments or heartbeat triggers.

Pulse TODO Use Cases

  • Tracking commitments made during conversations with users.
  • Automating recurring tasks like daily reviews, briefings, or system maintenance.
  • Managing blockers and dependencies where the agent is waiting on human input or external fixes.
  • Prioritizing autonomous work during heartbeat wake-up cycles.
  • Scheduling reminders for specific future dates and times.

How Pulse TODO Works

  1. The agent identifies a commitment, reminder, or recurring need during a session or from a system event.
  2. The task is immediately written to the TODO.md file in the workspace root, categorized by dependency.
  3. For tasks involving specific timing, the agent creates a corresponding Openclaw Skills cron job to ensure enforcement.
  4. During each heartbeat or wake-up trigger, the agent reads the TODO.md to determine the next logically aligned task.
  5. Completed tasks are verified and then marked off or updated, with any associated cron jobs being synchronized accordingly.

Pulse TODO Setup

To begin using this skill within your workspace, ensure you have the Openclaw Skills environment configured and follow these steps:

# Create the primary task tracking file
touch TODO.md

# Initialize the standard Pulse TODO structure
echo -e "# TODO\n\n## 📋 Tasks\n\n### Do it myself\n\n### Depends on human\n\n### Waiting on external\n\n## 🔄 Scheduled" > TODO.md

Refer to the setup.md file in the skill repository for specific cron permissions and agent profile integration.

Pulse TODO Data Schema & Taxonomy

The skill maintains a structured Markdown file at the workspace root named TODO.md. The schema is organized as follows:

Section Description
Do it myself Tasks actionable by the agent immediately without external blockers.
Depends on human Tasks requiring input, review, or action from a human user.
Waiting on external Tasks waiting on third-party fixes, PR merges, or external systems.
Scheduled Recurring or timed tasks linked to automated triggers.

Task Attributes:

  • repeat: <schedule>: Defines the recurrence pattern (e.g., daily 3:00).
  • once: <timestamp>: Defines a one-time execution window.
  • cron: <job-name>: Links the entry to a specific background job for Openclaw Skills synchronization.

Pulse TODO Advanced Features

  • Strategic Alignment: Logic that forces the agent to pick tasks based on high-level goals rather than the path of least resistance.
  • Cron Sync Enforcement: Automated management of background jobs to ensure that no scheduled task relies solely on the LLM context.
  • Stale Item Management: Built-in rules to flag or delete tasks that have been untouched for more than three days.
  • Multi-Dependency Tracking: Detailed grouping to distinguish between human blockers and external system upstream issues.
  • Heartbeat Optimization: Sophisticated wake-up logic that prevents task duplication and ensures efficient idle-time utilization.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*