NAME

repomatic lock-threads - Lock closed, inactive issues and PRs

SYNOPSIS

repomatic lock-threads [OPTIONS]

DESCRIPTION

Lock closed issues and pull requests left inactive too long.

Keeps spam and necro-posting off threads whose discussion is over, without touching anything still moving: the clock counts from a thread's last update, so a closed issue people are still replying to keeps resetting it.

Locking is one-way here. Nothing unlocks a thread on a schedule, and a thread already locked never reappears in the search, so re-running the command right after a run finds nothing left to do.

Issues repomatic maintains itself are excluded by default: they are meant to reopen when their condition recurs, which a lock would block.

Requires the gh CLI to be authenticated.

OPTIONS

--inactive-days INTEGER RANGE: Days without activity before a closed thread is locked.
--issue-comment TEXT: Comment posted on an issue before locking it. Empty to post none.
--pr-comment TEXT: Comment posted on a pull request before locking it. Empty to post none.
--exclude-label TEXT: Leave threads carrying this label unlocked. Repeatable.
--limit INTEGER RANGE: Maximum number of threads to examine in one run.
--reason [off_topic|resolved|spam|too_heated]: Reason recorded with the lock.
--repo TEXT: Repository in 'owner/repo' format. Defaults to $GITHUB_REPOSITORY.
--dry-run / --live: Report what would be done without making changes.
--help / -h: Show this message and exit.

ENVIRONMENT

LOCK_THREADS_INACTIVE_DAYS: Days without activity before a closed thread is locked.
LOCK_THREADS_ISSUE_COMMENT: Comment posted on an issue before locking it. Empty to post none.
LOCK_THREADS_PR_COMMENT: Comment posted on a pull request before locking it. Empty to post none.
LOCK_THREADS_EXCLUDE_LABELS: Leave threads carrying this label unlocked. Repeatable.
LOCK_THREADS_LIMIT: Maximum number of threads to examine in one run.
LOCK_THREADS_REASON: Reason recorded with the lock.
GITHUB_REPOSITORY: Repository in 'owner/repo' format. Defaults to $GITHUB_REPOSITORY.
LOCK_THREADS_REPO: Repository in 'owner/repo' format. Defaults to $GITHUB_REPOSITORY.
LOCK_THREADS_DRY_RUN: Report what would be done without making changes.
LOCK_THREADS__CLICK_DEFAULT_HELP: Show this message and exit.

EXIT STATUS

0: Success.
1: A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

EXAMPLES

Preview what a run would lock

repomatic lock\-threads

Lock them, as the autolock workflow does

repomatic lock\-threads \-\-live

Lock silently after six months, sparing triaged threads

repomatic lock\-threads \-\-live \-\-inactive\-days 180 \-\-issue\-comment "" \-\-exclude\-label "🚧 needs triage"

AUTHORS

Kevin Deldycke