npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

local-run-cli

v0.1.2

Published

Run a public domain locally with Caddy, local TLS, hosts-file updates, and DNS cache flushing on macOS.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

dafuga01dafuga01

Keywords

caddydnshostslocalhostproxytls

Readme

local-run

local-run maps a real domain to your local machine, provisions a local TLS certificate with Caddy, updates /etc/hosts, flushes macOS DNS caches, and runs the proxy in the background.

Warning: macOS only.

local-run currently supports macOS only. It relies on macOS DNS cache commands and local system paths that are not implemented for Linux or Windows.

Install

npm install -g local-run-cli

Usage

Start a local proxy for a real domain and forward it to your local app on port 5173:

local-run start --domain jungle4-account.unicove.com --port 5173

Stop the active proxy, remove the managed /etc/hosts entry, and flush DNS:

local-run stop

What it does

local-run start:

  • installs Caddy with Homebrew if it is missing
  • creates a Caddy config for https://<domain>
  • trusts Caddy's local CA
  • adds managed IPv4 and IPv6 localhost /etc/hosts entries
  • flushes macOS DNS caches
  • starts Caddy in the background
  • prints browser instructions to force the browser onto the local copy

local-run stop:

  • stops the background Caddy process
  • removes the managed /etc/hosts entry
  • flushes macOS DNS caches
  • removes its local state files

Browser notes

Browsers can keep DNS and socket caches even after the system DNS cache has been flushed. If the remote site still loads:

  • close existing tabs for the target domain
  • open a fresh tab or incognito window
  • in Chrome or Edge, open chrome://net-internals/#dns and clear the host cache
  • then open chrome://net-internals/#sockets and flush socket pools
  • hard refresh and verify the certificate issuer is Caddy's local authority

Development

npm test
node src/cli.js start --domain jungle4-account.unicove.com --port 5173
node src/cli.js stop