Schedule

Fallback method (IPC file)

If tool access is unavailable, write an IPC JSON file to $PICLAW_DATA/ipc/tasks/:

cat > "$PICLAW_DATA/ipc/tasks/schedule_$(date +%s).json" <<EOF
{
  "type": "schedule_task",
  "chatJid": "$PICLAW_CHAT_JID",
  "task_kind": "agent",
  "prompt": "Describe what should happen when this task fires",
  "schedule_type": "once",
  "schedule_value": "2026-03-09T09:00:00Z"
}
EOF

Shell command variant:

cat > "$PICLAW_DATA/ipc/tasks/schedule_$(date +%s).json" <<EOF
{
  "type": "schedule_task",
  "chatJid": "$PICLAW_CHAT_JID",
  "task_kind": "shell",
  "command": "ls -la /workspace",
  "cwd": ".",
  "timeout_sec": 30,
  "schedule_type": "interval",
  "schedule_value": "3600000"
}
EOF

Verify it was scheduled

After scheduling, confirm with SQL introspection:

SELECT id, chat_jid, task_kind, schedule_type, schedule_value, status, next_run
FROM scheduled_tasks
ORDER BY created_at DESC
LIMIT 5;

For execution history:

SELECT task_id, run_at, duration_ms, status
FROM task_run_logs
ORDER BY id DESC
LIMIT 10;

Managing existing tasks (IPC)

• Pause: { "type": "pause_task", "taskId": "task-xxx" }
• Resume: { "type": "resume_task", "taskId": "task-xxx" }
• Cancel: { "type": "cancel_task", "taskId": "task-xxx" }
• Update: { "type": "update_task", "taskId": "task-xxx", "prompt": "...", "model": "...", "schedule_value": "..." }
• Cleanup: { "type": "cleanup_tasks", "chatJid": "web:default" }

Notes

• Shell tasks are pre-validated (no newlines, no destructive patterns, cwd inside /workspace).
• Use UTC for human-facing schedules unless asked otherwise.
• Always acknowledge the created schedule and include next run time if available.

Environment

• PICLAW_DATA — piclaw data directory (contains ipc/, sessions/)
• PICLAW_CHAT_JID — JID of the triggering chat