CLI Reference: Scheduler

Commands for managing agent scheduling: deadlines, priorities, and cost budgets.

The scheduler tracks resource usage (token cost, wall time) per agent and per tool, and uses declared deadlines and priorities to influence execution order. See Scheduler for background.

ash scheduler stats

Show global scheduler statistics: per-tool usage and a summary of all agents.

ash scheduler stats

Output includes:

• Tool stats: invocation counts, total token cost, average latency per tool.
• Agent summaries: agent ID, name, priority, deadline (if set), total cost so far, and current state.

ash scheduler info

Show detailed scheduling information for a specific agent.

ash scheduler info <agent-id>

Output includes: priority, deadline, cost budget, tokens consumed, CPU time, and current scheduler state.

ash scheduler set-deadline

Set a deadline for an agent.

ash scheduler set-deadline <agent-id> <deadline>

The scheduler uses the deadline to prioritize agents approaching their time limit. An agent that misses its deadline is recorded in the audit log (it is not automatically terminated).

Example:

ash scheduler set-deadline <agent-id> 2026-06-01T12:00:00Z

ash scheduler clear-deadline

Remove a deadline from an agent.

ash scheduler clear-deadline <agent-id>

The agent returns to normal priority-based scheduling.

ash scheduler set-priority

Override an agent's scheduling priority.

ash scheduler set-priority <agent-id> <priority>

Higher-priority agents are preferred when the daemon is resource-constrained. The default priority is 50.

Example:

ash scheduler set-priority <agent-id> 90   # high-priority agent
ash scheduler set-priority <agent-id> 10   # low-priority background agent