Skip to content

f9-o/VulnCheck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VulnCheck

A Lightning-Fast, Zero-Config Local Container Security Orchestrator

Go Version License Release

Overview

VulnCheck orchestrates Docker-based security scanning (leveraging Gitleaks for secrets and Trivy for vulnerabilities) directly from your terminal. It provides a highly polished Bubble Tea Terminal UI (TUI), enabling you to catch critical security issues locally and prevent vulnerable code from ever reaching your upstream repository.

Key Features

Feature Description
Zero Configuration Operates on isolated Docker containers (aquasec/trivy & zricethezav/gitleaks). No complex host installation required.
Comprehensive Scanning Instantly identifies exposed credentials, API tokens, and package dependency vulnerabilities.
Elegant Interface Delivers a buttery-smooth terminal UI powered by Charm's Bubble Tea framework.
Native Git Hook Integration Run vulncheck hook install to strictly enforce security standards before every commit.

Quick Start

Installation via Curl (macOS & Linux)

curl -sL https://raw.githubusercontent.com/f9-o/vulncheck/main/install.sh | sudo bash

For Windows environments, please download the pre-compiled binary from the Releases page.

Building from Source

git clone https://github.com/f9-o/vulncheck.git
cd vulncheck
make build
make install

Usage Guide

Execute a Security Scan

Run an extensive scan on your current working directory. The application will automatically provision ephemeral Docker containers for the analysis.

vulncheck scan .

Deploy Git Pre-Commit Hook

Ensure your repository remains pristine and secure by automatically blocking commits that contain High or Critical severity findings:

vulncheck hook install

Architectural Design

  1. CLI Layer: Engineered using the robust cobra and viper frameworks.
  2. Orchestrator Engine: Interfaces natively with the local Docker daemon to securely mount and analyze source code using Trivy and Gitleaks.
  3. TUI Engine: Utilizes Bubble Tea to process and stream real-time JSON report ingestion metrics into a refined, high-performance dashboard layout.

Developed and maintained by f9-o.

About

A lightning-fast, zero-config local container security orchestrator.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors