Developer local for VibeControls
Local pre-commit secrets scanner (gitleaks protect) — runs on the developer machine.
vibe plugin install @vibecontrols/vibe-plugin-security-developer-local
About this plugin
@vibecontrols/vibe-plugin-security-developer-local serves the developer.local lifecycle stage. It registers itself with @vibecontrols/vibe-plugin-security under the per-stage provider type security.secrets (which is shared with the pull_request.* secrets variants — see PROVIDER_TYPE_FOR_STAGE in the meta plugin) and the provider name gitleaks-protect-semgrep. It wraps gitleaks protect (uncommitted-only, fast) plus Semgrep --quick when Python is available on PATH, for a sub-second pre-commit experience.
Wave 2 scaffold — real tool integration is pending; see src/provider.ts TODO.
Install
vibe plugin install @vibecontrols/vibe-plugin-security-developer-local
vibe security providers set-default --stage developer.local --provider gitleaks-protect-semgrep
The gitleaks binary is downloaded automatically on first use (sha256-verified per platform) into ~/.boff/vibecontrols/agents/<profile>/tools/gitleaks/. Semgrep is best-effort and only invoked when semgrep --version resolves on PATH.
Behavior (planned)
gitleaks protect --staged --no-banneragainst the working index — sub-second, never touches commit history.- Semgrep
--quick --config=p/cion changed files — only runs whenpython3+semgrepare on PATH. - Findings normalized to
category: "secret"withseverityderived from rule severity. - All evidence stored under the agent data dir; nothing leaves the host machine.
Configuration
Per-vibe config (stored in RepositorySecurityConfig.pluginAssignments["developer.local"].config):
provider: gitleaks-protect-semgrep
config:
semgrepEnabled: true # default; set false to skip Semgrep entirely
extraGitleaksArgs: []
extraSemgrepArgs: []
Use it in 30 seconds
- Make sure the agent is running:
vibe start - Install the meta first:
vibe plugin install @vibecontrols/vibe-plugin-security - Install this plugin:
vibe plugin install @vibecontrols/vibe-plugin-security-developer-local - List installed plugins:
vibe plugin list
Other Security plugins
Archive Offboard
Writes tombstone.json evidence at archive.offboard for SOC2/ISO retention proofs.
@vibecontrols/vibe-plugin-security-archiveDAST (preview)
OWASP ZAP baseline DAST scan against alpha preview URLs at deploy.preview.
@vibecontrols/vibe-plugin-security-dast-previewDeploy alpha smoke
TLS / HSTS / CSP smoke checks for alpha environment URLs at deploy.alpha.
@vibecontrols/vibe-plugin-security-deploy-alphaIncident response
Targeted incident-response scanner for incident.response lifecycle stage.
@vibecontrols/vibe-plugin-security-incidentRepo onboard
Repo profile detector — picks the right policy bundle on repo.onboard.
@vibecontrols/vibe-plugin-security-onboardPackage publish
Cosign signing + SLSA provenance at package.publish.
@vibecontrols/vibe-plugin-security-package-publish