Manual Setup

Tools

Manual Setup

Manual Workflow Setup

If you prefer to set up manually, create this workflow file:

# .github/workflows/schedule-issues.yml
name: Schedule Issues

on:
  issues:
    types: [opened, edited, closed, reopened, assigned, unassigned]
  schedule:
    - cron: '0 6 * * *'  # Run daily at 6am UTC
  workflow_dispatch:

permissions:
  id-token: write
  contents: read

concurrency:
  group: p2-schedule-${{ github.repository }}
  # cancel-in-progress causes noisy "Run cancelled" notifications
  # https://github.com/orgs/community/discussions/13015
  cancel-in-progress: true

jobs:
  schedule:
    runs-on: ubuntu-latest
    steps:
      - name: Schedule project
        uses: octoberswimmer/p2-github-scheduler@main

CLI Usage

A CLI is also available for local testing and debugging:

# Schedule issues from a GitHub Project
p2-github-scheduler https://github.com/orgs/myorg/projects/1

# Dry run (show changes without updating)
p2-github-scheduler --dry-run owner/repo

# Enable debug logging
p2-github-scheduler --debug owner/repo

The CLI authenticates via GITHUB_TOKEN environment variable or interactive device flow with secure keyring storage.