Installation

Installation

Zero-Install (npx)

npx @penumbraforge/gate

This runs Gate without installing it globally. On first run in a git repo, it automatically installs the pre-commit hook and scans your repo.

npm (Global)

npm install -g @penumbraforge/gate

Then run gate from any directory.

From Source

git clone https://github.com/penumbraforge/gate.git
cd gate
npm install
node bin/gate.js scan --all

Requirements

• Node.js 18+ (the only runtime requirement)
• Git (for hook installation and history scanning)
• No database, no server, no accounts, no API keys

Verifying Installation

gate version    # Shows version and rule count
gate status     # Shows hook status, config, and last scan

Updating

gate update     # Self-update to latest version

Or manually: npm install -g @penumbraforge/gate@latest