
100% Free & Open Source • Privacy-First Security Scanning and AI Code Review CLI
Free, open-source, privacy-first security scanning and AI code review CLI.
GuardScan runs static security and quality scanners locally, audits exact dependency versions against OSV, and optionally adds AI review with your own provider key (OpenAI, Claude, Gemini, OpenRouter, or local Ollama/LM Studio). It has no account, no billing and no hosted service, and it does not upload your source code to GuardScan.
Website: https://guardscancli.vercel.app
npm install -g guardscan
guardscan init
guardscan security --offline --no-cve # local-only scan
guardscan config # optional: configure an AI provider
guardscan run # local review, with AI enrichment if configured
The npm install needs Node.js 22 or newer. Homebrew, Scoop, pipx and standalone binaries (Node.js bundled) are also available from 1.1.1. Windows users should use Scoop, pipx, npm or npx. To try it without installing, run npx guardscan@latest <command> (Node.js 22 or newer); see docs/INSTALL.md.
The full user guide is the npm package README: cli/README.md (also shown at https://www.npmjs.com/package/guardscan).
| Topic | Page |
|---|---|
| First steps | Getting started |
| Install, upgrade, uninstall | docs/INSTALL.md |
| Every command, flag and exit code | docs/COMMANDS.md |
Offline mode, --fail-on, SARIF, GitHub Actions | docs/OFFLINE_AND_CI.md |
| Dependency vulnerability scanning | docs/VULNERABILITY_SCANNING.md |
| AI chat and providers | Chat guide, AI quick reference |
| Docker | docs/DOCKER_GUIDE.md |
| Language parsers | docs/LANGUAGE_PARSERS.md |
| Self-hosted telemetry collector | docs/TELEMETRY_COLLECTOR.md |
| Architecture decisions | docs/adrs |
| Quick command cheat sheet | QUICKSTART.md |
Policies: Privacy · Terms · Security · License
Syntax reference for the AI-assisted commands (see docs/COMMANDS.md for all options):
guardscan review --file <path>: AI code reviewguardscan docs --type <type>: generate documentationguardscan test-gen --file <path>: generate testsguardscan refactor --file <path>: refactoring suggestions| Path | Contents |
|---|---|
cli/ | The TypeScript CLI source, tests and the npm package |
docs/ | User documentation and architecture decision records |
catalog/ | Package-manager catalogs (Homebrew tap and others) used for release |
tasks/ | Maintainer working notes |
Report bugs and request features in GitHub Issues; ask questions in Discussions. Open a focused pull request with tests and a clear rationale. To build from source:
cd cli
npm ci
npm run build
npm test
Report vulnerabilities privately as described in SECURITY.md.
MIT, see LICENSE.