schedule

Generates launchd, cron, or Task Scheduler configs to start a Nightshift shift at a fixed time.

63|3|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/orwa-mahmoud/nightshift --skill schedule-orwa-mahmoud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schedule
Source: https://github.com/orwa-mahmoud/nightshift/tree/main/plugins/nightshift/skills/schedule
Command: npx skills add https://github.com/orwa-mahmoud/nightshift --skill schedule-orwa-mahmoud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a long-running agent shift at a fixed clock time requires correct scheduler configuration, queued work, and headless permissions; a mistake in any of these is only discovered when the scheduled run silently does nothing. This Skill walks through every preflight check and prints the exact scheduler config without registering anything. ## Core Features & Use Cases - Preflight validation: Verifies the Nightshift site exists, the punch list has open items, permissions support headless runs, and no shift is already armed before generating any config. - Scheduler config generation: Prints launchd, cron, systemd timer, or Windows Task Scheduler entries for a given HH:MM time via the ns schedule command, installing nothing. - Use Case: You want your Claude Code or Codex agent to start working a queued punch list at 2:00 AM. Run this Skill to confirm the work is queued and permissions hold, then receive the exact scheduler command to paste into your terminal. ## Quick Start Ask the agent to schedule my Nightshift shift to start at 02:00 and print the scheduler config for my platform.

Frequently Asked Questions about schedule

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule a Claude Code or Codex agent to start at a specific time?

Run the schedule Skill with a 24-hour HH:MM time. It validates the workspace and queued work, then prints a launchd, cron, systemd, or Task Scheduler config you install yourself; it registers nothing automatically.

How do I schedule a recurring automated coding task with cron or launchd?

Use the ns schedule command with --at HH:MM to generate the scheduler entry for your platform. On Linux you can pass --target systemd for user timers, and on Windows the equivalent PowerShell script produces a Task Scheduler config.

Does the schedule command install or register the scheduler entry?

No. The generator only prints the config and the command to register it. The owner runs that command manually, and --remove prints the command that unregisters an existing entry.

Why does a scheduled agent run do nothing at the scheduled time?

The most common cause is an empty punch list, since a scheduled start works only open items and promotes nothing from parked work orders or drafts. Missing headless permission grants can also stall the run on its first tool prompt.

Can I schedule a shift while another shift is already armed?

No. If a .shift-armed marker exists, the Skill stops and directs you to check status first, because the workspace has an active or stale shift rather than merely queued work.