taskflow
Structured project/task management for OpenClaw agents — markdown-first authoring, SQLite-backed querying, bidirectional sync, CLI, Apple Notes integration.
Best for markdown-heavy workflowsWorks with GitHub
⌘source
- author
@LeoYeAI- language
- Python
★2kstars
306forks
May 6, 2026
✦overview.md
Key Features
- ·Markdown-first authoring
- ·SQLite-backed querying
- ·Bidirectional sync
- ·CLI interface
- ·Apple Notes integration
Use Cases
- →Managing project tasks in a markdown-based workflow
- →Syncing tasks between Apple Notes and a project database
- →Querying task status using SQLite from command line
Best for
- ✓markdown-heavy workflows
- ✓Apple Notes users
- ✓CLI-oriented developers
Not ideal for
- !non-technical users
- !real-time collaboration
FAQs
name
taskflow
description
Structured project/task management for OpenClaw agents — markdown-first authoring, SQLite-backed querying, bidirectional sync, CLI, Apple Notes integration.
metadata:{"openclaw":{"emoji":"📋","os":["darwin","linux"],"requires":{"bins":["node"],"env":["OPENCLAW_WORKSPACE"]}}}
TaskFlow — Agent Skill Reference
TaskFlow gives any OpenClaw agent a structured project/task/plan system with markdown-first authoring, SQLite-backed querying, and bidirectional sync.
Principle: Markdown is canonical. Edit tasks/*.md directly. The SQLite DB is a derived index, not the source of truth.
Security
OPENCLAW_WORKSPACE Trust Boundary
OPENCLAW_WORKSPACE is a high-trust value. All TaskFlow scripts resolve file paths from it, and the CLI and sync daemon use it to locate the SQLite database, markdown task files, and log directory.
Rules for safe use:
-
Set it only from trusted, controlled sources. The value must come from:
- Your own shell profile (
.zshrc,.bashrc,/etc/environment) - The systemd user unit
Environment=directive in a template you control - The macOS LaunchAgent
EnvironmentVariablesdictionary you installed
Never accept
OPENCLAW_WORKSPACEfrom:- User-supplied CLI arguments or HTTP request parameters
- Untrusted config files read at runtime
- Any external input that has not been explicitly validated
- Your own shell profile (
$install
1-click copynpx skills add LeoYeAI/openclaw-master-skills --skill taskflowSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
3/ 5
goodMostly clear, but there are still a few confusing or poorly structured parts.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
3/ 5
mediumPartially actionable with several concrete steps, but still missing important details.