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@latest

View on GitHubRelease v0.1.2

What 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.md and docs/SECURITY.md on 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 that Contact and Expires are present once, that Expires is 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:

  1. github-pvr, GitHub private vulnerability reporting
  2. security.txt, a contact from a valid security.txt
  3. security.md-email, an email address in SECURITY.md
  4. security.md-link, a reporting link in SECURITY.md
  5. gitlab-confidential-issue, a GitLab confidential issue
  6. security.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

  1. A GitHub or GitLab repository

    disclose https://github.com/owner/repodisclose https://gitlab.com/group/subgroup/project
  2. A package or a domain

    disclose npm:@scope/packagedisclose pypi:requestsdisclose crates:serdedisclose example.com
  3. JSON 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-pad
  4. README 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:express
  5. Pinned 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}"

Machine-readable: JSON · Markdown · ID disclose

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