Skip to content

Scheduler & Agent Tools

Tools for scheduling future tasks, delegating to parallel sub-agents, distilling sessions into flows, and managing plans.

Scheduling Tools

ToolDescriptionConfirmation
schedule_jobCreate a scheduled job on a cron schedulealways-confirm
list_scheduled_jobsList all scheduled jobs with statusauto-approve
update_scheduled_jobUpdate a job's schedule or enable/disable italways-confirm
remove_scheduled_jobRemove a scheduled jobalways-confirm

schedule_job

Creates a recurring task that runs on a cron schedule:

schedule_job:
  name: "daily-backup"
  mode: "adaptive"
  schedule: "0 2 * * *"
  instructions: "Run database backup and upload to S3"

Modes:

  • routine — Runs a saved flow with fixed parameters (deterministic)
  • adaptive — An AI agent executes free-form instructions each run (flexible)

The daemon must be running for scheduled jobs to execute.

Delegation Tools

ToolDescriptionConfirmation
delegate_tasksSpawn parallel child agents for concurrent workalways-confirm
announce_planShow a structured plan checklist to the userauto-approve

delegate_tasks

Spawns up to 10 parallel child agents. See Sub-agents for full details.

announce_plan

Displays a structured plan to the user before starting multi-step work. Plan steps are automatically tracked as sub-tasks complete.

Flow & Discovery Tools

ToolDescriptionConfirmation
distill_flowConvert current session into a reusable flowalways-confirm
run_flowExecute a saved flowalways-confirm
search_flowsSearch for saved flows/workflowsauto-approve
search_toolsDiscover available tools by descriptionauto-approve
skill_lookupLoad instructions for a CLI tool or workflowauto-approve
list_team_membersList team members for delivery targetingauto-approve

distill_flow

Converts the current conversation into a reusable flow file. Captures the sequence of tool calls, decision points, and parameters. Equivalent to the /distill slash command.

search_tools

Searches for available tools by describing what you want to do. Found tools become available for the current session. Useful when the agent needs capabilities not in its default tool set.

skill_lookup

Loads detailed instructions for a specific CLI tool or workflow (e.g., git, docker, kubernetes). The instructions are injected into the agent's context for the current task.

See Skills for how skills work, Sub-agents for delegation patterns, and Flows for flow distillation.