Task Manager
SQLite-backed task management at ~/workspace/data/tasks.db.
Status Legend
| Mark | Status | Meaning |
|---|---|---|
[~] | BACKLOG | Not ready, waiting to be prioritized |
[ ] | READY | Actionable now |
[*] | IN-PROGRESS | Currently working |
[x] | COMPLETED | Done |
[!] | BLOCKED | Cannot proceed (has dependencies) |
CLI Commands
All commands use: bun ~/workspace/skills/task-manager/scripts/db-tasks.js
List Tasks
bash
bun ~/workspace/skills/task-manager/scripts/db-tasks.js list [filter]
Filters: backlog, ready, in-progress, completed, blocked, all (default)
Add Task
bash
bun ~/workspace/skills/task-manager/scripts/db-tasks.js add "<task description>" [backlog|ready]
Status defaults to backlog (recommended for new tasks).
Update Task Status
bash
bun ~/workspace/skills/task-manager/scripts/db-tasks.js update "<pattern>" <status>
Statuses: backlog, ready, in-progress, completed, blocked
Complete Task
bash
bun ~/workspace/skills/task-manager/scripts/db-tasks.js complete "<pattern>"
Marks matching task as completed.
Delete Task
bash
bun ~/workspace/skills/task-manager/scripts/db-tasks.js delete "<pattern>"
Count Tasks
bash
bun ~/workspace/skills/task-manager/scripts/db-tasks.js count
Returns: Backlog: N | Ready: N | In Progress: N | Completed: N | Blocked: N
Heartbeat Integration
- •Run
list readyto get actionable tasks - •Research the task before starting (use documentation, search, or browser automation as needed)
- •If unclear or missing prerequisites:
update "<task>" blockedand add a work note explaining why - •If clear: update to
in-progresswhen starting - •On success:
complete "<task>" - •On failure:
update "<task>" blocked
Architecture
- •Database:
~/workspace/data/tasks.db(SQLite with WAL mode) - •CLI:
skills/task-manager/scripts/db-tasks.js - •Dashboard API:
moltboard/src/app/api/tasks/route.ts
Cron Jobs
Set up using MoltBot cron. See MoltBot Cron Jobs documentation.
Task Worker (every 3 minutes)
bash
moltbot cron add "moltboard-worker" "*/3 * * * *" \
"./skills/task-manager/scripts/cron-worker.sh"
Picks up Ready tasks and processes them one at a time.
Project Sync (every 15 minutes)
bash
moltbot cron add "moltboard-sync" "*/15 * * * *" \
"bun ./skills/task-manager/scripts/project-sync-cron.js"
Syncs GitHub issues for projects with github_repo_url configured.
Migration
If migrating from todo.md:
bash
bun ~/workspace/scripts/init-db.js # Initialize database bun ~/workspace/scripts/migrate-tasks.js # Import from todo.md