Development & Code Intelligence Tool

The Repository Security Scan Tool

Run lightweight secret and unsafe-code heuristics across a repository snapshot to surface leaked credentials and risky patterns before they ship — governed and on infrastructure you control.

Explore VDF AI Agents
SecretsCredential leak detection
UnsafeRisky-pattern heuristics
Repo-wideScans the whole snapshot
100%On-prem, code never leaves
The Exposure Problem

A single leaked secret can undo every other control

Hard-coded API keys, tokens in config, and unsafe code patterns slip into repositories constantly. They’re easy to miss in review and catastrophic if they reach a public mirror or a breach.

01

Secrets hide in plain sight

A committed key looks like any other string until it’s abused.

02

Review misses risk

Reviewers focused on logic rarely scan for unsafe patterns.

03

Risk compounds over time

Old, unscanned code accumulates exposure no one is watching.

04

Scanning can’t leak code

Sending source to a hosted scanner is the exact risk you’re trying to avoid.

How the Tool Works

Heuristic scanning on a snapshot

Detection

Secrets and unsafe patterns

The high-impact misses.

The tool runs secret-detection and unsafe-code heuristics across a repository snapshot, surfacing leaked credentials and risky constructs that routine review tends to miss.

  • Credential and token detection
  • Unsafe-code heuristics
  • Whole-repository coverage
  • Scoped to a branch or commit
Repo
Wide Scan

Secrets + unsafe code

SecretsUnsafeHeuristicsCoverage

Workflow

A gate agents can enforce

Catch it before it ships.

An agent can run a scan on every change or on a schedule and block or flag anything that trips a heuristic — turning ad-hoc secret-hunting into a repeatable control.

Gate
Pre-ship Check

Block or flag

GateScheduledAutomaticRepeatable

Governance

On-premise scanning

Source stays internal.

The scan runs against a snapshot inside your perimeter with audit logging, so the very code you’re protecting is never sent to a third-party scanner.

100%
On-Prem

IP-safe, logged

On-premIP-safeAudit logPrivate
Inputs

Parameters

The security_scan tool accepts these inputs when an agent calls it. Required inputs are flagged.

Name Type Required Description
owner string Optional GitHub repository owner.
repo string Optional GitHub repository name.
ref string Optional Branch, tag, or commit SHA. Defaults to the default branch.
user_id integer Optional User ID for resolving a stored GitHub token.
Where it pays back

Where security scanning pays back

Pre-merge gating

Block a PR that introduces a leaked secret or unsafe pattern.

Legacy audits

Scan old repositories no one has security-reviewed.

Secret sweeps

Sweep a codebase for credentials before open-sourcing or sharing.

Continuous checks

Run scheduled scans to catch newly introduced risk.

Compliance evidence

Log scan results as evidence for security reviews.

Agent gating

Let a compliance or security agent enforce the scan in a network.

How VDF AI connects it

Assigned to agents, orchestrated as networks

On VDF AI, an industry’s use cases map to agents, and you assign tools like this one to those agents. Compose multiple agents into a governed, on-premise network.

ROI Snapshot

What changes after you assign it

Earlier
Secrets caught before ship
Repo-wide
No blind spots
Repeatable
Scanning as a control
100%
Scanned without code leaving
FAQ

Questions about the Repository Security Scan tool

What does the repository security scan tool do?

It runs lightweight secret-detection and unsafe-code heuristics over a GitHub repository snapshot, surfacing leaked credentials and risky patterns. Assigned to an agent, it becomes a repeatable security gate.

Is it a replacement for a full SAST suite?

It is a fast, heuristic first line of defense focused on the highest-impact misses — secrets and unsafe patterns — that catches issues early and complements deeper dedicated tooling.

Can it run automatically?

Yes. An agent can run it on every change or on a schedule and flag or block anything that trips a heuristic.

Does our code leave our infrastructure?

No. It scans a snapshot inside your perimeter with audit logging — the code you are protecting is never sent to a hosted scanner.

Which agents use it?

Engineering and compliance agents use it alongside code review and the PR review assistant to gate changes safely.

Stop secrets before they ship

See the repository security scan tool gate changes for a security agent — on infrastructure you control.