Category: DisclosureGoApache-2.0v0.1.2
disclose
Finds where to report a vulnerability. Give it a GitHub or GitLab repository, an npm, PyPI or crates.io package, or a domain, and it prints the reporting channels it found, ranked by priority.
go install github.com/ucsurf/disclose/cmd/disclose@latestWhat it does
Finding the private channel is often the slow part of reporting a bug. disclose checks the usual places and prints them with a priority. Lower numbers come first.
The checks in the README:
- GitHub private vulnerability reporting, with
GET /repos/{owner}/{repo}/private-vulnerability-reporting. SECURITY.md,.github/SECURITY.mdanddocs/SECURITY.mdon the default branch. It keeps email addresses and links that look like reporting channels (security, advisories, a bug bounty, HackerOne, Bugcrowd and similar).- security.txt (RFC 9116) at
https://<domain>/.well-known/security.txt. It checks thatContactandExpiresare present once, thatExpiresis RFC 3339 and not expired, and it warns if the date is more than a year ahead. - GitLab project metadata and
SECURITY.md, through the GitLab API, with a confidential issue link as a fallback. - For a package, the source repository and homepage from npm, PyPI (
project_urls) or crates.io, then the same repository and homepage checks.
Priority in the README:
github-pvr, GitHub private vulnerability reportingsecurity.txt, a contact from a valid security.txtsecurity.md-email, an email address in SECURITY.mdsecurity.md-link, a reporting link in SECURITY.mdgitlab-confidential-issue, a GitLab confidential issuesecurity.txt-expired, a contact from an expired or invalid security.txt
Exit code 0 means at least one channel was found, 3 means none were found, and 2 means a usage or input error. -v prints every check.
The README says the program is a single static binary and uses only the Go standard library. The license is Apache-2.0. GITHUB_TOKEN raises the GitHub API limit, and the private-vulnerability-reporting endpoint may need a token. Without a token the README says you get 60 GitHub API requests an hour. GITLAB_TOKEN is for private or rate-limited GitLab projects.
To report a vulnerability in disclose itself, use GitHub private vulnerability reporting on that repository.
Limits
It only reads public metadata. A program that is announced only on a website, and not in security.txt or SECURITY.md, will not appear. A link in SECURITY.md counts when it looks like a reporting channel. Run with -v to see every check. Non-domain targets are GitHub, GitLab.com, npm, PyPI and crates.io.
Usage
A GitHub or GitLab repository
disclose https://github.com/owner/repodisclose https://gitlab.com/group/subgroup/projectA package or a domain
disclose npm:@scope/packagedisclose pypi:requestsdisclose crates:serdedisclose example.comJSON for scripts
The README says --json returns input, target, repo, homepage, channels, checks and the parsed security.txt. -format is table (the default) or json. The default timeout is 30 seconds.
disclose --json npm:left-padREADME example for npm:express
The README shows a run dated 2026-11-01. The first channel is GitHub private vulnerability reporting for expressjs/express, then a security.txt contact at mailto:express-security@lists.openjsf.org.
disclose npm:expressPinned install used in the README’s CI example
The README then uses jq to require a channel with priority under 9. It says disclose does not fit a pre-commit hook because it makes network lookups. GITHUB_TOKEN and GITLAB_TOKEN are optional.
go install github.com/ucsurf/disclose/cmd/disclose@v0.1.2disclose --json "https://github.com/${GITHUB_REPOSITORY}"
More tools
- lockreview
Reviews GitHub Actions lockfile (actions.lock) diffs and flags repository identity changes, impostor commits, ref rollbacks, new transitive actions, and runs/dist changes.
ucsurf/lockreview - hookjack
Static scanner for commands that AI assistants and IDEs run on their own when you open a repository.
ucsurf/hookjack - repojack
Finds dependencies that point at a deleted or renamed GitHub account, so someone else could register the name and serve that code.
ucsurf/repojack - vuln-patterns
Semgrep rules taken from vulnerabilities that are already public.
ucsurf/vuln-patterns - pwnreq
Finds GitHub Actions workflows where someone without write access can run code that sees repository secrets: pwn requests and script injection.
ucsurf/pwnreq