🛡️ Shieldguard

Local-first SAST CLI tool written in Go that scans codebases for vulnerabilities and automatically fixes them using Ollama LLMs.

cli go security

What is it?

Shieldguard is a security tool designed for developers who need fast, reliable, and offline-capable tools. Built with Go for maximum performance and minimal resource usage.

Why should you care?

• 🚀 Fast — Compiled Go binary, no runtime dependencies
• 🔒 Secure — CodeQL security analysis + Dependabot
• 🌐 Offline-first — Works without internet connection
• 📦 Lightweight — Single binary, minimal footprint
• 🛠️ Developer-friendly — Clean CLI with helpful documentation

Quick Start

Prerequisites

• Go 1.21 or higher

Install from source

git clone https://github.com/AetherCodeHQ/shieldguard.git
cd shieldguard
go build -o shieldguard .

Run

./shieldguard --help

Usage

# Basic usage
./shieldguard --path ./target

# With options
./shieldguard --path ./target --format json --output report.json

# Verbose mode
./shieldguard --path ./target --verbose

Features

• ✅ High-performance Go implementation
• ✅ Cross-platform support (Windows, Linux, macOS)
• ✅ JSON export for CI/CD integration
• ✅ Colored terminal output
• ✅ Configurable via YAML/JSON
• ✅ Comprehensive documentation

CLI Flags

Flag	Description	Default
--path	Target directory	.
--format	Output format (json, text, badge)	text
--output	Output filename	stdout
--verbose	Enable verbose output	false
--config	Config file path	-

Examples

Basic scan

./shieldguard --path ./my-project

JSON report

./shieldguard --path ./my-project --format json --output report.json

CI/CD integration

# .github/workflows/scan.yml
- name: Run Shieldguard
  run: ./shieldguard --path . --format json --output report.json

Development

# Clone the repo
git clone https://github.com/AetherCodeHQ/shieldguard.git
cd shieldguard

# Build
go build -o shieldguard .

# Run tests
go test ./...

# Lint
golangci-lint run

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Security

If you discover a security vulnerability, please report it responsibly. See SECURITY.md for details.

License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Built with ❤️ by AetherCode • AetherCode-Core

---

What's New in v1.1.0

• Professional documentation with badges
• CI/CD pipeline with GitHub Actions
• Security analysis with CodeQL
• Dependency management with Dependabot
• Code quality with GolangCI-Lint
• Issue and PR templates
• Contributing guidelines

Categories

Category	Description
Other	This project is part of the AetherCode ecosystem

Related Projects

Part of AetherCode Core ecosystem.