Todo Manager for Openclaw

A lightweight, file-based task management system for AI agents that integrates with GitHub issues and project paths.

tangruilin
v1.0.0
Apr 13, 2026
0
783
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install todo-manage

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-manage 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 Manager?

Todo Manager is a specialized workflow designed for AI coding agents to maintain organized task lists within a developer's workspace. It streamlines the lifecycle of development tasks by categorizing them into pending, in-progress, and completed states. As a key component of Openclaw Skills, this tool is built specifically for technical workflows, allowing for direct association with project file paths, git branches, and GitHub issues, ensuring that the AI agent always has the full context of the work to be done.

Todo Manager Use Cases

  • Managing project development milestones and daily tasks within an IDE.
  • Linking specific TODO items to GitHub issues for better traceability.
  • Tracking work-in-progress across different git branches and specific file paths.
  • Rapidly querying and updating workspace tasks using fuzzy matching and natural language.

How Todo Manager Works

  1. The AI agent activates the skill when it detects keywords like TODO, task, or plan.
  2. When creating a task, the agent interactively prompts for GitHub issue links and relevant project paths.
  3. The skill stores data across three state-specific JSON files: pending, in_progress, and completed.
  4. Users can transition tasks through states (e.g., from pending to in_progress) using either descriptive keywords or numeric IDs.
  5. The system automatically maintains a metadata file to track global statistics and state consistency across the Openclaw Skills environment.

Todo Manager Setup

To use Todo Manager, ensure your AI agent has access to the workspace directory. The skill will automatically initialize the necessary JSON files upon the first command.

# Trigger task creation by speaking to your agent
# "Create a new TODO: implement user authentication"

Todo Manager Data Schema & Taxonomy

The skill organizes data in the workspace using a structured JSON schema across four files:

File Description
todos_meta.json Stores global statistics and sequence metadata.
todos_pending.json Contains all tasks that are currently in the queue.
todos_in_progress.json Tracks tasks currently being executed by the user or agent.
todos_completed.json Archives finished tasks with completion timestamps.

Each task entry typically includes content, createdAt, githubIssueUrl, paths, and branch (for git projects).

Todo Manager Advanced Features

  • Intelligent fuzzy matching to identify tasks without needing exact string matches.
  • Git integration that automatically associates tasks with specific branches and file paths.
  • Global sequence numbering (e.g., 1️⃣, 2️⃣, 3️⃣) for quick shorthand commands like 'complete 1'.
  • Interactive inquiry mode that ensures no critical metadata (like issue links) is missed during task creation.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*