Command

/scheduler

[advanced] Manage the scheduled workflow runner daemon (start/stop/status)

One command from octo.

shell

$ npx -y skills add nyldn/claude-octopus --agent claude-code

Ships with octo. Installing the plugin gets this command.

How it fires

How this command gets triggered: by you, by Claude, or both.

Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/scheduler

Context preview

What this command does when you run it.

[advanced] Manage the scheduled workflow runner daemon (start/stop/status)

Stats

Stars3,869

Forks362

LanguageShell

LicenseMIT

Ships with octo

Command definition

scheduler.md

---
command: scheduler
description: "[advanced] Manage the scheduled workflow runner daemon (start/stop/status)"
aliases:
  - sched
---

# Scheduler

Manage the Claude Octopus scheduled workflow runner daemon.

## MANDATORY COMPLIANCE — DO NOT SKIP

You MUST manage the scheduler only through the installed Octopus scheduler scripts after resolving the plugin root. You are PROHIBITED from:
- Reimplementing scheduler state changes manually
- Editing scheduler state files directly
- Skipping the plugin-root preflight because "I can do this faster directly"

## Usage


**Preflight — Ensure plugin root is resolvable (run via Bash tool FIRST):**

```bash
OCTO_ROOT="${HOME}/.claude-octopus/plugin"
if [[ ! -x "$OCTO_ROOT/scripts/orchestrate.sh" ]]; then
  helper="$OCTO_ROOT/scripts/helpers/ensure-plugin-root.sh"
  if [[ ! -x "$helper" ]]; then
    helper="$(find "${HOME}/.claude/plugins/cache" "${HOME}/Library/Application Support/Claude" "${LOCALAPPDATA:-/dev/null}/Claude" "${XDG_DATA_HOME:-${HOME}/.local/share}/Claude" -maxdepth 8 -path "*/nyldn-plugins/octo/*/scripts/helpers/ensure-plugin-root.sh" -print -quit 2>/dev/null)"
  fi
  [[ -x "$helper" ]] && bash "$helper" >/dev/null 2>&1 || true
fi