The app
Scheduled & triggered work
Ask in plain words: "Every Monday at 9:00, send me the top 5 Hacker News stories." The agent sets a wait on the TODO. When it fires, the agent wakes up in the same TODO with the message you gave it and does the work.

What can trigger a run
| Trigger | Example request | Under the hood |
|---|---|---|
| Delay | "Check the deploy again in 3 hours." | 3h |
| Clock / date | "Remind me tomorrow at 9." | 9:00, ISO date |
| Recurring | "Every weekday at 9:00 review overnight signups." | weekdays@9:00 --repeat |
| Webhook | "When Stripe sends a payment, thank the customer." | A word like payment mints a secret URL: POST https://wait.todofor.ai/hooks/h_… (JSON body ≤ 64 KB) |
| Deadline / race | "Wait for the signup, give up after 7 days." | signup || 7d |
| All of | "When deploy is done and tests pass, ship it." | deploy && tests |
| Stream | "Every time the log prints ERROR, investigate." | A command's output lines become events |
Rules
- Timezone: clock times follow your timezone, including daylight-saving changes.
- Maximum length: a wait, recurring ones included, stops after at most 30 days. Longer schedules need a new wait; ask the agent to set a reminder to renew it.
- Webhook URLs are the secret: anyone with the URL can fire it. Don't post it publicly.
- Cancel: ask the agent ("stop the Monday digest"), or it runs
tfa-wait cancel <id>. - Where the agent runs: the woken TODO uses the same agent and machines as before. If that agent works on your own PC, the PC must be online when the wait fires.
Where you see it
- Scheduled card on the board: each wait and its next fire time.
- Notifications: when the woken TODO finishes, fails or needs you.
- Messages tab and phone push: if the agent was asked to notify you.
Ideas
- Daily 8:00: summarise yesterday's support emails and draft replies.
- Mondays: pull last week's ad spend and post the numbers.
- On every new Stripe payment (webhook): send a personal thank-you email.
- Every 30 minutes for a day: watch a competitor's pricing page and report changes.
Last modified on