Getting Started

GreenGate is a single compiled Rust binary — no runtime dependencies, no package managers to fight.

Installation

Pre-compiled binary (recommended)

macOS (Apple Silicon / M1+):

curl -sL https://github.com/ThinkGrid-Labs/greengate/releases/latest/download/greengate-macos-arm64 \
  -o /usr/local/bin/greengate && chmod +x /usr/local/bin/greengate

macOS (Intel):

curl -sL https://github.com/ThinkGrid-Labs/greengate/releases/latest/download/greengate-macos-amd64 \
  -o /usr/local/bin/greengate && chmod +x /usr/local/bin/greengate

Linux (x64):

curl -sL https://github.com/ThinkGrid-Labs/greengate/releases/latest/download/greengate-linux-amd64 \
  -o /usr/local/bin/greengate && chmod +x /usr/local/bin/greengate

Windows (x64) — PowerShell:

Invoke-WebRequest -Uri "https://github.com/ThinkGrid-Labs/greengate/releases/latest/download/greengate-windows-amd64.exe" `
  -OutFile "$env:USERPROFILE\.local\bin\greengate.exe"
# Add $env:USERPROFILE\.local\bin to your PATH if not already present

Build from source (requires Rust 1.85+)

cargo install --git https://github.com/ThinkGrid-Labs/greengate

Verify installation

greengate --version
# greengate 0.2.6

Quick Start

# Scan for secrets and run SAST on JS/TS files
greengate scan

# Lint all Kubernetes YAML files
greengate lint --dir ./k8s

# Enforce 80% minimum test coverage
greengate coverage --file coverage/lcov.info --min 80

# Audit dependencies for known CVEs
greengate audit

# Install as a git pre-commit hook
greengate install-hooks

# Gate on Lighthouse web performance scores
greengate lighthouse --url https://yourapp.com

# Gate on React component performance regressions
greengate reassure

What GreenGate solves

Problem	Command
Hardcoded secrets pushed to git	greengate scan
XSS, eval, command injection in JS/TS	greengate scan (SAST)
Kubernetes manifests missing resource limits	greengate lint
Test coverage silently dropping	greengate coverage
Vulnerable dependencies shipping to production	greengate audit
Secrets committed before anyone notices	greengate install-hooks
Lighthouse score regressing between deploys	greengate lighthouse
React component render performance regressing	greengate reassure

Next steps

• Set up a configuration file to share settings across all commands
• Integrate with GitHub Actions or GitLab CI
• Explore individual command references