https://github.com/github/empty-repos
A GitHub Actions workflow to find empty repos
https://github.com/github/empty-repos
innersource ospo
Last synced: 9 months ago
JSON representation
A GitHub Actions workflow to find empty repos
- Host: GitHub
- URL: https://github.com/github/empty-repos
- Owner: github
- License: mit
- Created: 2025-05-04T22:44:00.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-22T05:34:23.000Z (11 months ago)
- Last Synced: 2025-08-02T07:41:57.761Z (10 months ago)
- Topics: innersource, ospo
- Homepage:
- Size: 32.2 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# Empty Repos Workflow
A GitHub Actions workflow that scans all repositories in your organization once a month (or on-demand) and files an issue listing:
- Repos that are completely **empty** (no files at root)
- Repos that contain **only a README** at the root
This helps you spot neglected or placeholder repositories and take action (archive, populate, delete, etc.).
## Features
- **Scheduled scan**: runs at 00:00 UTC on the 1st of every month
- **Manual trigger**: invoke from the **Actions** tab or via `gh workflow run`
- **Visibility filter**: choose to scan `all`, `public`, or `private` repos
- **Auto-issue creation**: opens a new issue with a Markdown table of results
- **Zero dependencies**: uses `actions/github-script`, built-in scheduling and permissions
## Installation
1. **Copy** the workflow in this repo, at
`.github/workflows/empty-repo.yml`
2. **Update** the organization name to scan:
```yaml
env:
SCAN_ORG: my-org-name # ← set this to your GitHub org
## License
[MIT](LICENSE)
## More OSPO Tools
Looking for more resources for your open source program office (OSPO)? Check out the [`github-ospo`](https://github.com/github/github-ospo) repository for a variety of tools designed to support your needs.