Add task-memory skill and heartbeat suppression

[atharvapatiil]

PR Summary

Feature 1: Persistent Task Memory (00d2303)

Added a task-memory skill that gives TinyClaw persistent task tracking via Claude Code's native skills system.

How it works

• Claude auto-detects task intent from natural language ("remind me", "todo", "don't forget")
• Creates individual markdown files with YAML frontmatter in .tinyclaw/tasks/active/
• Maintains a lightweight index.json for quick scanning
• Supports recurring tasks, dependencies (blocked_by), and priority levels
• Completed/cancelled tasks move to .tinyclaw/tasks/completed/

Heartbeat integration

• Updated .tinyclaw/heartbeat.md with a smart checklist — checks overdue, due-today, due-within-1-hour tasks
• Added HEARTBEAT_OK suppression in queue-processor — when nothing is due, the heartbeat response is silently discarded instead of being written to the outgoing queue

Files added

File	Purpose
.claude/skills/task-memory/SKILL.md	Core skill instructions
.claude/skills/task-memory/templates/task-template.md	YAML frontmatter template for new tasks
.claude/skills/task-memory/examples/sample-tasks.md	Few-shot examples (explicit, implicit, recurring, dependencies)
docs/plans/2026-02-09-persistent-memory-task-tracking-design.md	Design doc

---

Feature 2: TypeScript Migration (a1de864)

Migrated the codebase from JavaScript to TypeScript with strict mode.

New structure

src/
  types.ts              — shared interfaces (QueueMessage, ResponseMessage, TaskIndexEntry)
  queue-processor.ts    — converted from queue-processor.js
  whatsapp-client.ts    — converted from whatsapp-client.js
tsconfig.json           — src/ → dist/, strict, sourceMaps, declarations
dist/                   — compiled output (gitignored)

What changed

• Both .js files moved to src/ as .ts with full type annotations
• Shared types.ts defines the queue message protocol as interfaces
• tsconfig.json compiles src/ → dist/ with strict mode, source maps, and declaration files
• package.json updated with build / build:watch scripts, added typescript, @types/node, @types/qrcode-terminal as devDeps
• tinyclaw.sh now runs node dist/*.js and auto-builds TypeScript if source files are newer than compiled output
• .gitignore updated to exclude dist/

Key design decision

Zero runtime dependencies added — TypeScript is a devDependency only. Production runs compiled JS via node dist/.

[jlia0]

This is a very cool skill to add, would you mind explaining a little bit on how would we benefit from task-skill? Is it more like scheduling task with cron jobs?

[atharvapatiil]

thanks! @jlia0 its similar idea to cron but way more flexible

The core advantage is everything stays natural language end to end. you just talk to it normally and it figures out what to track:

• "remind me every friday to review open PRs" (sets up recurring)
• "after the tests pass, deploy to staging" (understands dependencies)
• "push the groceries thing to next week" (reschedules naturally)
• "whats overdue?" (queries the task list)

With cron these are all separate problems you need to define upfront. here the behaviour is just prompt instructions that claude interprets at runtime, so it adapts to whatever you throw at it without any predefined rules

The other thing is cron is fire and forget, it doesnt understand context. this skill reads the full task state every 5 min and makes judgement calls, like nudging you about a task. Thats been sitting for a week with no due date, or not bothering you about low priority stuff when theres urgent things pending. that kind of situational awareness is hard to get with static scheduling.

This is a very cool skill to add, would you mind explaining a little bit on how would we benefit from task-skill? Is it more like scheduling task with cron jobs?

[dagelf]

Can't you do this with the existing heartbeat.md?

edit: I see it's just a more elaborate version of that.

[dagelf]

Would be great if it's skills for tinyclaw and not just for claude