CLI
Use the gh-scheduler command-line tool to create, list, pause, and run schedules.
CLI
Use the gh-scheduler CLI to create, list, pause, and run schedules from your terminal.
Installation
curl -fsSL https://raw.githubusercontent.com/manascb1344/preciseactions/master/install.sh | shBinaries are available for Linux and macOS on amd64 and arm64.
Authenticate
gh-scheduler auth loginThis opens a browser to complete GitHub OAuth and stores a JWT session locally.
Commands
| Command | Description |
|---|---|
gh-scheduler auth login | Authenticate via GitHub OAuth |
gh-scheduler add | Create a new schedule |
gh-scheduler list | List all schedules |
gh-scheduler get <id> | Get schedule details |
gh-scheduler update <id> | Update a schedule (cron, name, ref, timezone, active) |
gh-scheduler delete <id> | Delete a schedule |
gh-scheduler pause <id> | Pause a schedule |
gh-scheduler resume <id> | Resume a paused schedule |
gh-scheduler run <id> | Trigger an immediate manual dispatch |
gh-scheduler history <id> | Show execution history for a schedule |
Examples
Create a schedule that runs ci.yml every 15 minutes:
gh-scheduler add --repo owner/repo --workflow ci.yml --cron "*/15 * * * *"Create a schedule with timezone and custom name:
gh-scheduler add --repo owner/repo --workflow deploy.yml \
--cron "0 9 * * 1-5" \
--timezone "America/New_York" \
--name "Weekday morning deploy"Update a cron expression:
gh-scheduler update <schedule-id> --cron "0 */2 * * *"Global flags
| Flag | Default | Description |
|---|---|---|
--api-url | http://localhost:8080 | Override the API server URL |