TaskFlow provides a robust, markdown-centric project and task management framework for Openclaw Skills with SQLite synchronization and automated background daemons.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install taskflow
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 taskflow 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 TaskFlow?
TaskFlow is a developer-centric skill designed to give AI agents a structured yet flexible system for managing projects, tasks, and architectural plans. It adheres to the principle that markdown is the canonical source of truth, allowing users to edit task files directly while a background daemon synchronizes changes to a SQLite database for advanced querying and reporting. By integrating seamlessly into the Openclaw Skills ecosystem, it bridges the gap between human-readable documentation and machine-queryable data.
This skill is particularly powerful for long-running agentic workflows where maintaining state across sessions is critical. It includes built-in security protocols to handle workspace boundaries safely and offers optional integrations like Apple Notes for real-time status tracking on macOS. Whether you are managing a single repository or a complex multi-agent environment, TaskFlow ensures your projects remain organized and accessible.
TaskFlow Use Cases
- Maintaining long-term project state across multiple AI agent sessions using Openclaw Skills.
- Synchronizing task lists between markdown files and a queryable SQLite database.
- Generating automated project status reports for human review via CLI or Apple Notes.
- Creating structured architectural plans and roadmaps that agents can reference as context.
- Orchestrating complex task dependencies with priority levels and owner tags.
How TaskFlow Works
- The user or agent defines a project in the PROJECTS.md registry using a unique slug.
- Markdown-based task files are created using a specific template containing headers for In Progress, Backlog, and Done states.
- A background sync daemon (LaunchAgent or systemd) monitors files and updates a central SQLite index every 60 seconds.
- Agents query the SQLite database or read markdown files to understand current project context and task status within the Openclaw Skills environment.
- Updates are performed by moving task lines between markdown sections, which the sync engine then propagates back to the database.
TaskFlow Setup
Add the workspace path to your shell profile:
export OPENCLAW_WORKSPACE="/path/to/your/.openclaw/workspace"
Link the CLI and run the setup wizard to initialize the Openclaw Skills environment:
ln -sf {baseDir}/scripts/taskflow-cli.mjs /usr/local/bin/taskflow
taskflow setup
To enable background synchronization, install the daemon:
taskflow install-daemon
TaskFlow Data Schema & Taxonomy
TaskFlow organizes data within the workspace using a specific hierarchy to ensure compatibility with Openclaw Skills workflows:
| File/Directory | Purpose |
|---|---|
PROJECTS.md |
Central registry for project names, slugs, and statuses. |
tasks/*.md |
Markdown task lists using specific syntax: - [ ] (task:id) [Px] [owner] title. |
plans/*.md |
Optional architecture and design documents. |
memory/taskflow.sqlite |
The derived index for high-performance querying and history tracking. |
logs/ |
Standard output and error logs for the sync daemon. |
Task IDs follow a strict <slug>-NNN format to ensure sequential ordering and easy referencing.
TaskFlow Advanced Features
- Bidirectional synchronization between markdown files and SQLite databases.
- Automated Apple Notes export for real-time project dashboards on macOS.
- Multi-platform support for background daemons via LaunchAgents (macOS) and systemd (Linux).
- Advanced CLI for project status auditing, task addition, and manual sync triggers.
- Secure path resolution and parameterized query engine to prevent SQL injection and directory traversal within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
MoltRock
An autonomous on-chain hedge fund enabling AI agents to pool USDC, earn compounding vault shares, and govern strategies via meritocratic voting.
Obsidian Official CLI
A comprehensive command-line interface for Obsidian that enables full control over vaults, notes, and system settings directly from the terminal.
Notify Bot
A CLI utility designed to trigger Telegram bot sessions and send targeted notifications within group threads.
Xianyu Auto Fulfillment Framework
A highly extensible automation framework designed to detect Xianyu payments and trigger customizable virtual goods delivery workflows.
Feast
Feast is an immersive meal planning system that transforms weekly cooking into a cultural experience with authentic recipes and automated shopping.
Prediction Bridge Search
An AI agent skill that searches prediction market events and market snapshots using text queries or X (Twitter) links via the Prediction Bridge API.
METADATA
Featured*
