cron-manager

Cron Manager

Use the telclaude maintenance cron CLI for scheduled-job CRUD.

Read

List jobs with machine-readable output first:

pnpm dev maintenance cron list --all --json

Use pnpm dev maintenance cron status --json when you need scheduler state or next-run data.

Create

Choose exactly one schedule flag:

• --at <iso>
• --every <duration>
• --cron "<minute hour day month weekday>"

Choose exactly one action:

• --social [serviceId]
• --private
• --prompt "<user-facing task>"

Prompt options:

• --skill <name> can be repeated to restrict scheduled skill use. Use --skill for unattended routines that need tools; passing no --skill preserves the default private-agent skill policy.
• --preprocess-command <path-or-executable> runs an executable before the prompt, with optional repeated --preprocess-arg <value>, --preprocess-cwd <path>, --preprocess-timeout-ms <ms>, and --preprocess-max-stdout-bytes <bytes>.
• Preprocessors receive JSON on stdin and non-empty stdout is injected as untrusted read-only data. Empty stdout runs the agent without preprocess context; [IDLE] or [SILENT] skips the agent run.
• Scheduled agent output containing [IDLE] or [SILENT] is treated as successful no-delivery output.

Delivery targets:

• --delivery origin
• --delivery home --owner <ownerId>
• --delivery chat --chat-id <chatId> [--thread-id <threadId>]

Examples:

pnpm dev maintenance cron add \
  --name "weekday-hn" \
  --cron "0 9 * * 1-5" \
  --prompt "Check Hacker News and post a short summary here." \
  --delivery home \
  --owner admin \
  --json

pnpm dev maintenance cron add \
  --name "team-digest" \
  --cron "30 14 * * 1-5" \
  --prompt "Summarize open background jobs for the team." \
  --delivery chat \
  --chat-id 123456789 \
  --thread-id 42 \
  --json

Update / Delete

• Enable: pnpm dev maintenance cron enable <id>
• Disable: pnpm dev maintenance cron disable <id>
• Remove: pnpm dev maintenance cron remove <id>
• Run now: pnpm dev maintenance cron run <id>

Telegram-specific notes

• /sethome persists the delivery destination for --delivery home.
• If the system prompt includes identity: <localUserId> (linked), use that as --owner.
• If the chat is unlinked, use tg:<chatId> as the owner id.
• Cron expressions are UTC. Be explicit about that when translating natural-language schedules.