A value-safe inventory tool for finding credential references across GitHub repositories where the authenticated user has maintain or admin access.
Warning
Generated reports are sensitive operational artifacts. Treat them as confidential.
Reports do not contain secret values, but they can expose private repository and organization names, credential names, infrastructure and provider details, file paths, source locations, access gaps, and possible credential exposures. That information can help an attacker map systems and prioritize targets.
Do not commit reports, publish them, paste them into public issues or chats, or share them outside the intended security/operations team without reviewing and redacting them first. Store reports only in an access-controlled location and delete copies that are no longer needed.
The auditor combines:
- GitHub secret metadata: names and timestamps only; GitHub never returns secret values.
- Current source snapshots: environment-variable, workflow-secret, and configuration references.
- Rotation notes: repository settings links and provider-side credential-management links.
- Coverage notes: repositories and organization secret stores that could not be inspected.
- Secret values are never written to the report, JSON, CSV, or console.
- Generated inventories are ignored by Git so repository names and private findings are not committed accidentally.
- Known credential formats are detected only to flag their locations; detected values are omitted.
- Temporary repository snapshots are created outside the project directory.
The .gitignore reduces accidental commits, but it does not prevent someone from force-adding, uploading, copying, or otherwise disclosing a report.
- Python 3.10 or newer
- Git
- GitHub CLI authenticated to the account being audited
Authenticate with the minimum useful scopes:
gh auth login -h github.com -p https --web --scopes repo,read:org,workflowListing organization-level secret names additionally requires organization-admin rights and the admin:org scope:
gh auth refresh -h github.com -s admin:orgThe broader scope is optional. Without it, the report identifies inaccessible organization stores rather than silently treating them as empty.
python3 audit_github_credentials.pyThe script writes:
credential-rotation-inventory.md: human-readable rotation runbookcredential-rotation-inventory.csv: sortable credential-reference inventorycredential-rotation-inventory.json: complete machine-readable results
Caution
All three output files may contain private infrastructure metadata. Keep them out of source control and public collaboration systems. Review and redact them before sharing, even when the audience is internal.
Re-running the command refreshes these files. To reuse already downloaded snapshots during development, set AUDIT_CLONE_ROOT to their directory.
Run
python3 audit_github_credentials.py, review the generated credential rotation inventory, and summarize urgent findings. Never print or copy secret values. Distinguish configured GitHub secrets from source-only references and call out every inaccessible organization store as a coverage gap.
The assistant should not rotate or revoke credentials unless the user separately authorizes those changes.
- Configured GitHub secrets are names returned by repository, environment, Dependabot, or Codespaces metadata APIs.
- Referenced credentials are credential-shaped names found in source or automation but absent from the returned repository stores. They may be organization secrets, external deployment variables, local credentials, examples, or stale references.
- Possible committed literals need immediate manual review. Values remain omitted. Base64 is encoding, not encryption.
- Organization coverage explains whether each organization store was readable with the current role and token scopes.
This is a rotation inventory, not proof that a repository is credential-free. Dynamic names, encrypted files, binaries, external reusable workflows, large files, vendored dependencies, and credentials held only in systems such as Vault, Kubernetes, OpenShift, cloud CI, or deployment platforms may require separate inspection.
Licensed under the Apache License 2.0.