Letta Code SDK

Appearance

Scheduling ​

Fresh

Source: Letta Code Scheduling

Overview ​

Letta enables automation of agent messages on predetermined schedules for tasks like daily briefings, hourly email triage, or periodic code reviews. Agents can also self-schedule via bundled skills.

Setup Methods ​

GUI Approach ​

Configure through the Letta Code app's Schedules tab, with support for remote devices.

CLI Approach ​

Start a server and use letta cron commands:

bash
letta server

Core CLI Commands ​

Add a Scheduled Task ​

bash
letta cron add \
  --agent agent-123 \
  --conversation default \
  --name "daily-review" \
  --description "Summarize recent code changes every morning" \
  --prompt "Review recent changes and summarize any issues." \
  --cron "0 9 * * *"

Scheduling Methods ​

MethodFlagExample
Cron expression--cron"0 9 * * 1-5" (weekdays at 9am)
Interval--every5m, 1h, 30s
One-time--at"in 45m", "2026-04-20T10:00:00"

List Tasks ​

bash
letta cron list
letta cron list --agent agent-123

Get Task Details ​

bash
letta cron get <task-id>

Delete a Task ​

bash
letta cron delete <task-id>

Task Requirements ​

Each task requires:

FieldRequiredDescription
--nameYesHuman-readable task name
--descriptionYesWhat the task does
--promptYesThe message to send to the agent
--agentYesAgent ID to execute the task
--conversationNoDefaults to LETTA_CONVERSATION_ID or default
Schedule flagYesOne of --cron, --every, or --at

Usage Examples ​

Daily Code Review ​

bash
letta cron add \
  --agent agent-123 \
  --name "daily-review" \
  --description "Review code changes" \
  --prompt "Review yesterday's commits and summarize issues." \
  --cron "0 9 * * 1-5"

One-Time Reminder ​

bash
letta cron add \
  --agent agent-123 \
  --name "deploy-reminder" \
  --description "Remind to deploy" \
  --prompt "Reminder: Deploy the staging branch to production." \
  --at "in 45m"

Frequent Monitoring ​

bash
letta cron add \
  --agent agent-123 \
  --name "health-check" \
  --description "Check service health" \
  --prompt "Run health checks on all services." \
  --every 5m

Limitations ​

Important Limitations

  • Tasks only execute while letta server is connected
  • One-shot tasks are marked missed if 5+ minutes late
  • Maximum 50 active tasks per agent
  • All commands output JSON for scripting compatibility

Verification Checklist ​

  • [ ] letta server is running
  • [ ] letta cron add creates task successfully
  • [ ] letta cron list shows the task
  • [ ] Task executes at scheduled time
  • [ ] Agent responds with expected output
  • [ ] One-shot tasks are cleaned up after execution

See Also ​