Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/trufflehogLinux, cloud and containers

trufflehog

⁨Auth/lab ref: TruffleHog secret scanning; verified secret types, git/cloud/CI sources, validation evidence, remediation workflow.⁩

v2026.11.13-21cd5683 installs+3 in 7 days39 StarsAGPL-3.0synced 10 hours ago

Install

No NotHoly CLI yet? Install it first.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install aeondave/trufflehog

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
+cRzr+D4ov…cGFk4JDg==The CLI checks the SHA-256 and the signature before it writes a file.
Package290928e5…3059174f
290928e554ed…f7233059174f2 files · ⁦3.6 KB⁩
ScanLow1 finding
  • Links to outside domains
See the full scan
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/vuln-scanners/trufflehog@21cd568

Secrets scanner with live credential verification — finds + validates real active secrets.

Quick Start

bash
# Scan local git repo
trufflehog git file://. --only-verified

# Scan GitHub repo
trufflehog git https://github.com/org/repo --only-verified

# Scan filesystem
trufflehog filesystem /path/to/project --only-verified

# JSON output
trufflehog git file://. --only-verified --json

Subcommands (Scan Sources)

Command Target
trufflehog git <url> Git repository (local or remote)
trufflehog github GitHub repos / org
trufflehog gitlab GitLab repositories
trufflehog filesystem <path> Files and directories
trufflehog s3 AWS S3 buckets
trufflehog docker Docker images
trufflehog gcs Google Cloud Storage
trufflehog circleci CircleCI pipelines
trufflehog jenkins Jenkins instances
trufflehog postman Postman collections
trufflehog elasticsearch Elasticsearch indices
trufflehog stdin Read from stdin

Core Flags

Flag Purpose
--only-verified Output only confirmed-valid secrets (low noise)
--no-verification Skip API verification, show all pattern matches
--results <types> Filter: verified,unknown,unverified (default: all)
--json JSON output
--branch <branch> Specific branch to scan
--since-commit <sha> Scan from commit SHA (CI delta scanning)
--max-depth <n> Limit git history depth
--concurrency <n> Concurrent workers (default: CPU count)
--max-decode-depth <n> Iterative decoding passes (catches base64-encoded secrets)
--include-paths <file> File with regex patterns for paths to include
--exclude-paths <file> File with regex patterns for paths to exclude
--exclude-globs <globs> Comma-separated glob patterns to exclude
--include-detectors <list> Enable specific detectors only
--exclude-detectors <list> Disable specific detectors
--config <file> Custom detector config file
--fail Exit non-zero when results found

Verification: The Key Differentiator

trufflehog actually tests if secrets work by calling the issuing service API:

Result Meaning
Verified Secret confirmed valid — active, real threat
Unknown Verification failed (network error / API unavailable)
Unverified Pattern matched but credential invalid/expired

No data is altered during verification. Only read-only auth checks.

bash
# CI/CD gate: only verified = real, active secrets
trufflehog git file://. --only-verified --fail
echo $?  # non-zero = live secrets found

# Show verified + unknown (be thorough)
trufflehog git file://. --results=verified,unknown --json

# Skip verification (fast pattern scan only)
trufflehog git file://. --no-verification --json

Common Workflows

bash
# Scan repo since last CI commit (delta scan)
trufflehog git file://. \
    --since-commit "$CI_COMMIT_BEFORE_SHA" \
    --only-verified --fail

# Scan specific branch
trufflehog git file://. --branch main --only-verified

# Limit to recent 500 commits
trufflehog git file://. --max-depth=500 --only-verified

# Full organization scan (GitHub)
trufflehog github --org=MyOrg \
    --token=$GITHUB_TOKEN \
    --include-members \
    --include-wikis \
    --issue-comments --pr-comments \
    --only-verified --json

# Docker image scan
trufflehog docker --image myapp:latest --only-verified

# S3 bucket scan
trufflehog s3 --bucket my-bucket --only-verified

# Decode base64 / encoded secrets
trufflehog filesystem . --max-decode-depth=3 --only-verified

# Exclude paths
trufflehog git file://. \
    --exclude-paths=exclude.txt \
    --exclude-globs="*.log,*.lock,vendor/*" \
    --only-verified

GitHub Actions

yaml
name: TruffleHog Secrets Scan
on: [push, pull_request]
jobs:
  trufflehog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: TruffleHog OSS
        uses: trufflesecurity/trufflehog@main
        with:
          path: ./
          base: ${{ github.event.repository.default_branch }}
          head: HEAD
          extra_args: --only-verified

Output Parsing (JSON)

bash
trufflehog git file://. --only-verified --json > findings.json

# Key fields in each finding:
# .DetectorName    - type of secret (aws, github, slack, etc.)
# .Verified        - true/false
# .Raw             - redacted secret value
# .SourceMetadata.Data.Git.File   - file path
# .SourceMetadata.Data.Git.Commit - commit SHA
# .SourceMetadata.Data.Git.Email  - author email

# Extract finding summary
cat findings.json | jq '{detector: .DetectorName, file: .SourceMetadata.Data.Git.File, commit: .SourceMetadata.Data.Git.Commit, verified: .Verified}'

# List unique secret types found
cat findings.json | jq -r '.DetectorName' | sort -u

# Only show verified with file+commit context
cat findings.json | jq 'select(.Verified == true) | {type: .DetectorName, file: .SourceMetadata.Data.Git.File, commit: .SourceMetadata.Data.Git.Commit}'

Resources

File When to load
references/custom-detectors.md Custom detector YAML config, verification endpoints, filtering strategy

Files in this version

Permissions

PermissionDeclaredFound by the scan
Reads filesYesYes
Writes filesYesYes
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v2026.11.13-21cd568Nov 13, 202621cd568290928e5Signed–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login