alexstormwood/Commits Within Time

A helper action that returns true if commits are detected on a repository within a supplied timeframe.

View on GitHub

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit May 2, 2026
License: GPL 3.0

Pinned Snippet

workflow.ymlSHA-pinned

uses: alexstormwood/commitswithintime@42a9ed3d95b888e05cf77960e09392768ccc0e23 # v1.1.12

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
seconds	How many seconds back you'd like to check from the workflow's current time.	no	0
minutes	How many minutes back you'd like to check from the workflow's current time.	no	0
hours	How many hours back you'd like to check from the workflow's current time.	yes	24
days	How many days back you'd like to check from the workflow's current time.	no	0
months	How many months back you'd like to check from the workflow's current time.	no	0
years	How many years back you'd like to check from the workflow's current time.	no	0
usernamesToIgnore	Commits authored or committed by usernames listed here will be ignored in the check.	no	{"ignoredUsernamesList": ["ExampleBlockedUsername1","ExampleBlockedUsername2"]}
emailAddressesToIgnore	Commits authored or committed by email addresses listed here will be ignored in the check.	no	{"ignoredEmailAddressesList": ["exampleIgnoredEmail@test.com","exampleIgnoredEmail@email.com"]}
usernamesToFocus	Commits authored or committed by usernames listed here will be the ONLY commits considered in the check.	no	{"allowedUsernamesList": []}
emailAddressesToFocus	Commits authored or committed by email addresses listed here will be the ONLY commits considered in the check.	no	{"allowedEmailAddressesList": []}
includeGithubActor	If set to true, commits by the user who triggered this workflow will be included in the check. Default is true.	no	true
includeActionsUser	If set to true, commits by the 'actions-user' Github Actions account will be included in the check. Default is false.	no	false
exportToFile	Set to true if you want the result of this Action to be stored as a JSON file in your repository's Artifact section.	no	false

Outputs

name	description
has-new-commits-within-time	True or false, depending on if commits have been detected with a timestamp within the specified timeframe.
number-of-commits-within-time	Whole number of commits detected that are within the specified timeframe.
total-commits	Whole number of commits detected on the repository/branch overall, even the ones not within the specified timeframe.