OpenParable
Skip to content
← Back to skills

Metaschedule

Productivity
metaschedule

Metaschedule is an Agent Skill for productivity published in the xvirobotics/metabot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

MetaBot's persistent server-side scheduler (cron + one-shot). Optional skill — not installed by default. Use when the user wants tasks that survive Claude session restarts, are visible to other bots, or need to run in MetaBot's PM2 process rather than this Claude session.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/xvirobotics/metabot/blob/HEAD/src/skills/metaschedule/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/metaschedule, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

MetaBot Scheduler

Persistent server-side scheduler. Use this when:

  • The schedule needs to outlive the current Claude session.
  • Another bot or operator may need to list, pause, or cancel it.
  • You want it to run inside MetaBot's PM2 process (not Claude's).

For ad-hoc, session-scoped scheduling, prefer the Claude Code native tools CronCreate and /loop instead — they're faster, in-process, and need no MetaBot server call.

Quick Commands (metabot CLI)

The metabot CLI is pre-installed and handles auth automatically.

# One-time delayed tasks
metabot schedule list                                       # List all scheduled tasks
metabot schedule add <bot> <chatId> <delaySec> <prompt>     # Schedule a one-time future task
metabot schedule cancel <id>                                # Cancel a scheduled task

# Recurring (cron)
metabot schedule cron <bot> <chatId> '<cronExpr>' <prompt>  # Create recurring task
metabot schedule pause <id>                                 # Pause a recurring task
metabot schedule resume <id>                                # Resume a paused recurring task

Cron format: minute hour day month weekday (5 fields). Examples:

  • 0 8 * * * → daily at 8am
  • 0 8 * * 1-5 → weekdays at 8am
  • */30 * * * *→ every 30 minutes Default timezone: Asia/Shanghai.

API Reference

Auth header: -H "Authorization: Bearer $METABOT_API_SECRET" Base URL: !echo http://localhost:${METABOT_API_PORT:-9100}

Create one-time scheduled task:

curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"botName":"<bot>","chatId":"<chatId>","prompt":"<task>","delaySeconds":3600,"label":"Reminder"}'

Create recurring task (cron):

curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"botName":"<bot>","chatId":"<chatId>","prompt":"<task>","cronExpr":"0 8 * * 1-5","timezone":"Asia/Shanghai","label":"Daily report"}'

Update task (prompt, delay, or cron):

curl -s -X PATCH http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id> \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"updated prompt","delaySeconds":7200}'

curl -s -X PATCH http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id> \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"cronExpr":"0 9 * * *","prompt":"Updated prompt","timezone":"Asia/Shanghai"}'

Pause / resume recurring task:

curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id>/pause \
  -H "Authorization: Bearer $METABOT_API_SECRET"
curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id>/resume \
  -H "Authorization: Bearer $METABOT_API_SECRET"

Cancel:

curl -s -X DELETE http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id> \
  -H "Authorization: Bearer $METABOT_API_SECRET"

Installation (opt-in)

This skill is not installed by default. To enable it for one bot, copy it into the bot's working directory:

mkdir -p <bot-work-dir>/.claude/skills/metaschedule
cp $METABOT_HOME/src/skills/metaschedule/SKILL.md <bot-work-dir>/.claude/skills/metaschedule/SKILL.md
# Mirror for Codex bots:
mkdir -p <bot-work-dir>/.codex/skills/metaschedule
cp $METABOT_HOME/src/skills/metaschedule/SKILL.md <bot-work-dir>/.codex/skills/metaschedule/SKILL.md

Or install globally so every Claude session picks it up:

mkdir -p ~/.claude/skills/metaschedule
cp $METABOT_HOME/src/skills/metaschedule/SKILL.md ~/.claude/skills/metaschedule/SKILL.md