# ๐Ÿ› ๏ธ Complete CLI Command Reference โ€” v1.1.1 Exhaustive reference for all commands supported by the `vforge` / `velociforge` binary. --- ## ๐Ÿ“ฆ `vforge pack` Bundles `node_modules` into a compressed `.vforge` virtual archive and `.vforge.json` cryptographic manifest. ```bash vforge pack [--algo ] [--encrypt ] ``` --- ## โšก `vforge ci` / `vforge restore` Ultra-fast extraction or **0.00ms** warm lockfile fingerprint verification. ```bash vforge ci [--force] [--decrypt ] ``` --- ## ๐Ÿ”„ `vforge run ` / `vforge boot` Ephemeral run: mounts zero-copy virtual symlink, runs command, auto-cleans disk on exit. ```bash vforge run npm start vforge run node server.js ``` --- ## ๐Ÿ“‹ `vforge list` / `vforge ls` Reads `.vforge` archive directly and lists all installed package names and versions in **0.25ms**. ```bash vforge list vforge ls ``` --- ## ๐ŸŒ `vforge p2p` / `vforge lan` Starts a **VelociRadix-powered** LAN P2P cache node that lets teammates pull `.vforge` archives over Wi-Fi instantly. ```bash # Start sharing node on your machine vforge p2p # Pull archive from a LAN peer vforge p2p pull http://192.168.1.21:3457 ``` --- ## ๐Ÿ›ก๏ธ `vforge guard` / `vforge sandbox` Zero-Trust malicious script inspector. Scans all installed package lifecycle scripts for dangerous shell patterns (curl, eval, wget, SSH key access). ```bash vforge guard ``` --- ## ๐Ÿ” `vforge diff` / `vforge delta` Recursively discovers all `.vforge.json` manifests in the project tree, then computes exact package additions, removals, version updates, and archive size deltas between any two manifests. ```bash # Auto-compare current manifest vs latest snapshot vforge diff # Compare two specific manifest files vforge diff .vforge.json .vforge-snapshots/my-backup/.vforge.json ``` --- ## โ˜๏ธ `vforge edge` / `vforge cloud` Generates a turnkey **GitHub Actions** CI/CD workflow that caches and restores `.vforge` archives at sub-millisecond speed. ```bash vforge edge ``` --- ## ๐Ÿงน `vforge shrink` Tree-shakes `node_modules` by stripping docs, markdown files, and source maps to save up to 30% space. ```bash vforge shrink ``` --- ## ๐Ÿฉบ `vforge doctor` Self-diagnostic health checker and environment auditor. Checks Node.js version, RAM-disk support, global cache location, and symlink compatibility. ```bash vforge doctor ``` --- ## ๐Ÿ“ธ `vforge snapshot ` Local dependency snapshot and rollback manager. ```bash vforge snapshot create "my-backup" vforge snapshot list vforge snapshot restore "my-backup" ``` --- ## ๐Ÿ’ก `vforge advisor` / `vforge optimize` AI optimization advisor that recommends lighter, faster package alternatives. ```bash vforge advisor ``` --- ## ๐Ÿ›ก๏ธ `vforge security` Scans installed modules for CVE vulnerabilities and GPL/AGPL copyleft licenses. Generates CycloneDX 1.4 & SPDX 2.3 SBOM manifests. ```bash vforge security ``` --- ## ๐Ÿ“– `vforge docs` Launches the interactive **VitePress** documentation engine at `http://localhost:4000`. ```bash vforge docs ``` --- ## ๐ŸŒ `vforge ui` Launches the interactive web analytics dashboard (VelociRadix Powered) at `http://localhost:3456`. ```bash vforge ui [--port 3456] ``` --- ## ๐Ÿ” `vforge inspect` Inspects `.vforge` archive metadata, compression details, and SBOM contents. ```bash vforge inspect ``` --- ## ๐Ÿš€ `vforge bench` Runs a live benchmark comparing standard `npm ci` vs VelociForge restoration speed. ```bash vforge bench ``` --- ## ๐Ÿข `vforge monorepo` Scans monorepo workspace packages and graph topology (supports pnpm, Turborepo, Nx, Lerna). ```bash vforge monorepo ``` --- ## ๐Ÿณ `vforge export` Exports optimized Dockerfile layers using `.vforge` as the dependency layer. ```bash vforge export ``` --- ## ๐Ÿงน `vforge clean` Cleans temporary swap files. Use `--all` to also remove the `.vforge` archive. ```bash vforge clean vforge clean --all ```