Pitchfork-and-Torch | v2.1.2 The Dry Run

NetForge

Local network performance tuning and optional hardening for Windows, macOS, and Linux. Prefer Ethernet. Resilient encrypted DNS. Captive-portal aware. Zero telemetry.

See The Dry Run Windows macOS Linux

Why NetForge

Feature matrix

CapabilityWindowsmacOSLinux
Prefer Ethernet metrics / orderYesYesYes
Encrypted DNS preferenceDoHPlain DNS APIDoT (resolved)
Captive portal helperYesYesYes
VPN respect modeYesYesYes
Dry-run / what-ifYesYesYes
Status JSON + HTMLYesYesYes
Optional hardening flagsYesYesYes

v2.1.2 named cut

The Dry Run

Preview first. The receipt below is a labeled SAMPLE of what -DryRun / --dry-run prints. It is not a live scan of this browser and it does not apply settings.

  1. 01 Inspect Run status. See adapters, DNS, and VPN tunnels before any plan.
  2. 02 Plan Dry-run prints [plan] lines. Nothing is written yet.
  3. 03 Review Read the receipt. VPN adapters stay skipped when RespectVpn is on.
  4. 04 Apply Only after you elevate. Install is a separate command.
SAMPLE plan only · nothing applied · not this host
[plan] SAMPLE receipt  -  nothing applied
[plan] Prefer Ethernet: raise Ethernet metric, lower Wi-Fi
[plan] Skip VPN / tunnel adapters (RespectVpn default)
[plan] DNS: resilient resolvers + encrypted DNS where the OS supports it
[plan] TCP: well-known stack profile
[plan] Captive helper: skip VPN adapters, use captive DNS, then restore
[plan] Hardening flags: off unless config says so
[plan] Re-apply on logon / network connect: not installed yet

Windows:  .\src\NetworkAuto.ps1 -DryRun
macOS/Linux:  sudo ./src/network-auto.sh --dry-run

How to read the plan

Prefer Ethernet
Raise the wired interface metric (or service order on macOS) so Ethernet wins over Wi-Fi when both are up.
Skip VPN / tunnel
RespectVpn / RESPECT_VPN is on by default. Common VPN and tunnel adapters are left alone.
DNS
Resilient public resolvers, plus DoH on Windows and DoT on systemd-resolved Linux where the OS supports it.
TCP
A documented well-known stack profile. Not a speed-test and not a fake Mbps meter.
Captive portal
The helper skips VPN adapters, uses captive DNS, then restores. A NetworkAuto dry-run does not apply that relax.
Hardening
Off unless your config turns flags on. Aggressive options stay behind review.

Install (review first)

Windows (Admin PowerShell)

git clone https://github.com/Pitchfork-and-Torch/netforge.git
cd netforge\windows
.\src\Get-NetForgeStatus.ps1
.\src\NetworkAuto.ps1 -DryRun
.\src\Install-NetworkAuto.ps1

macOS / Linux

git clone https://github.com/Pitchfork-and-Torch/netforge.git
cd netforge/macos   # or netforge/linux
./src/netforge-status.sh
sudo ./src/network-auto.sh --dry-run
sudo ./src/install-network-auto.sh

Philosophy and non-goals

NetForge hardens your host network stack. It does not configure your router, fix ISP caps, or replace privacy routing tools.

Composes with trench-coat (privacy routing) and ghost-continuum (defense plane).

FAQ

How does NetForge improve network performance?

It prefers Ethernet over Wi-Fi via interface metrics (or service order on macOS), applies well-known TCP stack settings, sets resilient public DNS with encrypted DNS where the OS supports it, and re-applies on logon and network connect so settings stick after sleep or network changes.

Is NetForge safe with VPNs?

Yes when RespectVpn / RESPECT_VPN is enabled (default in v2). NetForge skips common VPN and tunnel adapters so it does not fight split-tunnel or corporate VPN routing. Corporate profiles further reduce hardening side effects.

Does it collect data?

No. There is no telemetry, no account, and no cloud requirement for the core apply path. Logs and last-run files stay under local application data directories.

How do I handle captive portals?

Run the platform captive-portal helper. It skips VPN adapters when RespectVpn is on, uses captive DNS, and restores after the portal login. A dry-run of the main apply does not relax DNS.

Can I preview changes first?

Yes. Use NetworkAuto.ps1 -DryRun on Windows or network-auto.sh --dry-run on macOS/Linux. This page also shows a labeled SAMPLE receipt. It does not apply anything in the browser.

Source