🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › clawdo - Todo List for Agents
🦀 ClawHub

clawdo - Todo List for Agents

by @lepetitpince

Todo list and task management for AI agents. Add, track, and complete tasks with autonomy levels — agents propose work, humans approve. Works in heartbeats, cron, and conversations. Persistent SQLite CLI with structured JSON output.

Versionv1.1.4
Downloads2,767
Installs9
Stars⭐ 2
Comments2
#database#data#legal#automation#productivity
TERMINAL
clawhub install clawdo

📖 About This Skill

name: clawdo version: 1.1.4 author: LePetitPince homepage: https://github.com/LePetitPince/clawdo description: "Todo list and task management for AI agents. Add, track, and complete tasks with autonomy levels — agents propose work, humans approve. Works in heartbeats, cron, and conversations. Persistent SQLite CLI with structured JSON output." tags: - todo - task-queue - task-management - agent-tools - productivity - heartbeat - workflow - autonomous keywords: - todo list - task queue - todo - tasks - agent tasks - persistent tasks - heartbeat tasks - agent todo - task management - agent workflow - autonomous execution - agent collaboration categories: - productivity - agent-tools - workflow metadata: { "openclaw": { "emoji": "🦞", "requires": { "bins": ["clawdo"] }, "install": [ { "id": "npm", "kind": "npm", "package": "clawdo", "bins": ["clawdo"], "label": "Install clawdo (npm global)", }, ], }, }

🦞 clawdo — The missing todo list for AI agents

Your agent has memory files, cron jobs, and chat. It has no todo list.

No way to say "do this when you get to it." Not "do this at 14:00 UTC." Not "do this right now in this conversation." Just... remember to do it. Track it. Pick it up when there's a gap.

That's clawdo.

Install

clawhub install clawdo    # installs skill + docs into your workspace
npm install -g clawdo     # install the CLI binary

Requirements: Node.js ≥18

Quick Start

# Capture a task
clawdo add "update dependencies" --urgency soon
Agent checks its queue (heartbeat, cron, conversation — wherever)

clawdo inbox --format json
Agent works it

clawdo start a3f2
clawdo done a3f2 --json

add → inbox → start → done. Persistent state in SQLite. Every command has --json so agents parse structured output, not terminal art.

Where it fits

clawdo works everywhere agents work:

  • Heartbeat loops — "anything in my queue? let me do it between checks"
  • Cron jobs — "every hour, process one task"
  • Conversations — "J mentioned fixing the auth module, let me capture that"
  • Pipes and sub-agents — non-TTY safe, no interactive prompts

    • Heartbeat integration example

    # In HEARTBEAT.md — runs every ~30 minutes
TASKS=$(clawdo inbox --format json)
AUTO=$(echo "$TASKS" | jq '.autoReady | length')
    if [ "$AUTO" -gt 0 ]; then
  TASK=$(clawdo next --auto --json | jq -r '.task.id')
  clawdo start "$TASK" --json
  # ... do the work ...
  clawdo done "$TASK" --json
fi

    Autonomy levels

    Tasks can be tagged with permission tiers that control what the agent is allowed to do unsupervised:

    | Level | Time Limit | What it means | |-------|------------|---------------| | auto | 10 min | Agent does it silently. Fix a typo, run tests. | | auto-notify | 30 min | Agent does it, tells the human when done. | | collab | Unlimited | Human required. Complex, risky, or ambiguous. |

    Default: collab (safe).

    Key rule: Autonomy is a permission, not a suggestion. Once set, agents can't change it. If an agent fails 3 times, autonomy *demotes* to collab. Safety only moves down, never up.

    Agents propose, humans approve. Agent tasks always start as proposed. The human runs clawdo confirm or it doesn't happen.

    Usage

    For humans

    # Add tasks — inline metadata parsing
clawdo add "deploy new API +backend auto-notify now"

              └── text ──────┘ └project┘ └─level──┘ └urg┘
    View
    
clawdo list                       # active tasks
clawdo list --status proposed     # agent suggestions
clawdo next                       # highest priority
    Review agent proposals
    
clawdo confirm                # approve
clawdo reject                 # reject
    Work
    
clawdo start 
clawdo done 
clawdo done abc,def,ghi           # complete several

    For agents

    # Check inbox (structured)
clawdo inbox --format json
    Propose work
    
clawdo propose "add input validation" --level auto --json
    Execute
    
TASK=$(clawdo next --auto --json | jq -r '.task.id // empty')
if [ -n "$TASK" ]; then
  clawdo start "$TASK" --json
  # ... do the work ...
  clawdo done "$TASK" --json
fi

    The inbox returns: autoReady, autoNotifyReady, urgent, overdue, proposed, stale, blocked.

    Inline syntax

    clawdo add "fix auth bug +backend @code auto soon"

  • +word → project
  • @word → context
  • auto / auto-notify / collab → autonomy level
  • now / soon / whenever / someday → urgency
  • due:YYYY-MM-DD → due date

    • Security

  • Immutable autonomy — agents cannot escalate permissions
  • Proposal limits — max 5 active, 60s cooldown
  • Prompt injection defense — input sanitization, parameterized SQL
  • Audit trail — append-only log of every state change
  • Secure IDs — crypto.randomInt(), no modulo bias

    • Resources

  • GitHub: https://github.com/LePetitPince/clawdo
  • npm: https://www.npmjs.com/package/clawdo
  • Full docs: clawdo --help

    • License

    MIT

    💡 Examples

    For humans

    # Add tasks — inline metadata parsing
clawdo add "deploy new API +backend auto-notify now"

              └── text ──────┘ └project┘ └─level──┘ └urg┘
    View
    
clawdo list                       # active tasks
clawdo list --status proposed     # agent suggestions
clawdo next                       # highest priority
    Review agent proposals
    
clawdo confirm                # approve
clawdo reject                 # reject
    Work
    
clawdo start 
clawdo done 
clawdo done abc,def,ghi           # complete several

    For agents

    # Check inbox (structured)
clawdo inbox --format json
    Propose work
    
clawdo propose "add input validation" --level auto --json
    Execute
    
TASK=$(clawdo next --auto --json | jq -r '.task.id // empty')
if [ -n "$TASK" ]; then
  clawdo start "$TASK" --json
  # ... do the work ...
  clawdo done "$TASK" --json
fi

    The inbox returns: autoReady, autoNotifyReady, urgent, overdue, proposed, stale, blocked.