Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
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.
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.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
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.
clawhub install clawdo # installs skill + docs into your workspace npm install -g clawdo # install the CLI binary Requirements: Node.js ≥18
# 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.
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
# 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
Tasks can be tagged with permission tiers that control what the agent is allowed to do unsupervised: LevelTime LimitWhat it meansauto10 minAgent does it silently. Fix a typo, run tests.auto-notify30 minAgent does it, tells the human when done.collabUnlimitedHuman 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 <id> or it doesn't happen.
# 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 <id> # approve clawdo reject <id> # reject # Work clawdo start <id> clawdo done <id> clawdo done abc,def,ghi # complete several
# 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.
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
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
GitHub: https://github.com/LePetitPince/clawdo npm: https://www.npmjs.com/package/clawdo Full docs: clawdo --help
MIT
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.