Advanced scheduling through the letta cron CLI for other conversations, computers, run history, and schedule replacement. Use Wake for ordinary create/list/cancel operations in the current conversation.
84%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
This skill lets you create, list, and manage scheduled tasks using the letta cron CLI. Scheduled tasks send a prompt to the agent on a timer — useful for reminders, periodic check-ins, and deferred follow-ups.
For ordinary one-shot or recurring work in the current conversation, use Wake instead. Wake is self-bound and covers create, list, and cancel without routing choices.
--computer <deviceId> runs the scheduled work on another connected computer (get the ID from letta computers list). If that computer is offline at fire time, the occurrence fails (TARGET_DEVICE_UNAVAILABLE).
All commands go through letta cron via the Bash tool. Output is JSON.
letta cron add --name <short-name> --description <text> --prompt <text> <schedule>Required flags:
| Flag | Description |
|---|---|
--name <text> | Short identifier for the task (e.g. "dog-walk-reminder") |
--description <text> | Human-readable description of what the task does |
--prompt <text> | The message that will be sent to the agent when the task fires |
Schedule (pick one):
| Flag | Type | Example |
|---|---|---|
--every <interval> | Recurring (cron shorthand) | 5m, 2h, 1d |
--at <time> | One-shot | "in 45m", "2026-09-24T09:00:00-07:00" |
--cron <expr> | Raw cron (recurring) | "0 9 * * 1-5" |
Optional flags:
| Flag | Description |
|---|---|
--agent <id> | Agent ID (defaults to LETTA_AGENT_ID from the current shell/session) |
--conversation <id> | Conversation target: omit or pass new for a fresh conversation per fire; pass self for the current conversation; pass default for the agent default; or pass a concrete ID |
--computer <id> | Execute on another connected computer |
--once | Mark --at as one-shot (already the default for --at) |
letta cron listOptional filters: --agent <id>, --conversation <id>
get accepts an ID or name:
letta cron get <id-or-name> [--agent <id>]letta cron runs --id <task-id> [--limit <n>] [--agent <id>]If exact routing matters, pass both --agent and --conversation explicitly.
letta cron add falls back to LETTA_AGENT_ID for the agent. An omitted --conversation means "new", so every fire gets a fresh conversation. Pass --conversation self to capture the current LETTA_CONVERSATION_ID, --conversation default for the agent default, or a concrete conversation ID.
Safest pattern:
letta cron add \
--name "email-check" \
--description "Daily email summary in this conversation" \
--prompt "Check the user's email and post a summary here." \
--cron "0 10 * * *" \
--agent "$LETTA_AGENT_ID" \
--conversation selfThen verify the binding explicitly:
letta cron list --agent "$LETTA_AGENT_ID" --conversation selfdelete accepts an ID or name; remove is an alias.
# Delete a specific task
letta cron delete <id-or-name> [--agent <id>]
# Delete all tasks for one agent
letta cron delete --all --agent "$AGENT_ID"In-place editing is not available. To change a schedule, create and verify the replacement before deleting the old one.
Recurring expressions (both --cron and the expression --every compiles to) are interpreted in UTC. Convert the user's requested time to UTC before writing the expression: 9am PDT is 16:00 UTC, so use --cron "0 16 * * *" (17:00 UTC during PST). State the conversion in your reply so the user can catch a wrong assumption.
For a one-shot calendar request such as "tomorrow at 9am," resolve the date in the user's timezone and pass --at an RFC 3339 timestamp with an explicit offset. Infer a reasonable timezone from available context instead of asking a redundant follow-up. State the timezone you used in the confirmation (for example, "Scheduled for 9:00 AM PT") so the user can correct the assumption. A bare clock such as --at "9:00am" uses the current process timezone, which may be UTC; use it only when that is the intended timezone. Relative values such as --at "in 45m" do not need a timezone.
letta cron add \
--name "dog-walk-reminder" \
--description "Daily 9am (America/Los_Angeles) reminder to walk the dog" \
--prompt "Hey! It's 9am — time to walk the dog." \
--cron "0 16 * * *"Note: --every 1d fires daily at midnight UTC, so use --cron for a specific time of day, converting the user's time to UTC first.
letta cron add \
--name "deploy-check" \
--description "One-time check on deployment status" \
--prompt "Check the deployment status and report the result here." \
--at "in 30m" \
--agent "$LETTA_AGENT_ID" \
--conversation selfletta cron add \
--name "timesheet-reminder" \
--description "Weekday 5pm (America/Los_Angeles) timesheet reminder" \
--prompt "Friendly reminder: don't forget to submit your timesheet before EOD!" \
--cron "0 0 * * 2-6"Note the day shift: 5pm UTC−7 is midnight UTC the next day, so weekdays Mon–Fri become 2-6. Always re-derive both the hour and the day fields after converting.
letta cron listIf you need to confirm the exact conversation a task is bound to, list with explicit filters instead:
letta cron list --agent "$AGENT_ID" --conversation "$CONVERSATION_ID"letta cron delete dog-walk-reminderThe --prompt value is what gets sent to you (the agent) when the task fires. Write it as a message that will make sense when you receive it later, with enough context to act on:
Include context about what the user originally asked for, so you can give a helpful response when the prompt arrives.
letta cron add uses --agent first, then LETTA_AGENT_ID. Omit --conversation for a fresh conversation per fire; use --conversation self to capture LETTA_CONVERSATION_ID explicitly.--at for specific times: prefer RFC 3339 with an explicit offset. A bare --at "3:00pm" uses the process timezone and schedules tomorrow if that time has already passed there.For --cron, use numeric 5-field cron syntax (named days/months, seconds, ?, L, and # are not supported):
┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6, Sun=0)
│ │ │ │ │
* * * * *Common patterns (UTC):
*/5 * * * * — every 5 minutes0 */2 * * * — every 2 hours0 9 * * * — daily at 9:00 UTC0 9 * * 1-5 — weekdays at 9:00 UTC30 8 1 * * — 8:30 UTC on the 1st of each monthletta-ai/letta-code
a472af0
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.