agentio-schedule

name	agentio-schedule
description	Use to manage agentio scheduled .run.md prompts in watched folders.

Schedule via agentio

Auto-generated from agentio skill schedule. Do not edit by hand.

agentio schedule add

Watch a folder for .run.md files

Options:

• --no-host-pin: Do not pin this folder to the current host

Examples:

  # watch a folder of .run.md files (pinned to this hostname by default)
  agentio schedule add ~/Dropbox/schedules

  # watch but allow any host to fire (for non-Dropbox-synced folders)
  agentio schedule add ./agents --no-host-pin

After adding, author .run.md files in the folder directly. The daemon picks
them up via fs.watch within ~500ms. Run 'agentio schedule list' to confirm.

agentio schedule list

List watched folders and scheduled tasks

Options:

• --folder <path>: Filter schedules to one folder
• --folders: Show watched folders only (no schedules)
• --all-hosts: Include schedules pinned to other hosts

Examples:

  # watched folders + their detected schedules (host-pinned only)
  agentio schedule list

  # also show schedules pinned to other machines (Dropbox-shared folders)
  agentio schedule list --all-hosts

  # only schedules in one specific folder
  agentio schedule list --folder ~/Dropbox/schedules

  # just the watched-folder list, no schedule scan
  agentio schedule list --folders

agentio schedule show

Show a schedule and next run times

Options:

• --folder <path>: Restrict resolution to this folder

Examples:

  # frontmatter + next 5 fire times for one schedule (id is the .run.md basename)
  agentio schedule show weekly-report

  # disambiguate when the same id exists in multiple watched folders
  agentio schedule show weekly-report --folder ~/Dropbox/schedules

agentio schedule run

Run a schedule immediately

Options:

• --folder <path>: Restrict resolution to this folder
• -q, --quiet: Suppress streaming child output to stdout/stderr (used when invoked by the daemon)

Examples:

  # fire a schedule now (delegates to the daemon if running, else runs in-process)
  agentio schedule run weekly-report

  # restrict id resolution to one watched folder
  agentio schedule run weekly-report --folder ~/Dropbox/schedules

Manual runs ignore the host pin — useful for testing on a machine that isn't
the schedule's normal home.

agentio schedule history [id]

List past runs (no id: last run of every job; with id: all runs of that job)

Options:

• --folder <path>: Restrict to one folder

Examples:

  # overview: last run of every job across all watched folders
  agentio schedule history

  # full run history for one schedule (newest first)
  agentio schedule history weekly-report

  # restrict the overview to one folder
  agentio schedule history --folder ~/Dropbox/schedules

Per-run logs land in <folder>/.agentio/runs/<id>/<ISO>.log.

agentio schedule remove

Stop watching a folder

Examples:

  # stop watching a folder (existing .run.md files are not deleted)
  agentio schedule remove ~/Dropbox/schedules