@solez-ai/portly
v1.3.1
Published
Zero-config localhost tunnel CLI for developers.
Maintainers
Readme
Portly
Portly is a zero-config localhost sharing CLI with smarter detection, safer defaults, and script-friendly automation.
npx @solez-ai/portlyFeatures
- Scan all listening local ports (not only a fixed short list)
- Framework fingerprinting from headers + HTML signatures
- Multi-app selection when several local servers are detected
- Local health checks before tunnel startup
- Public reachability checks after tunnel startup
- Uses Cloudflare Quick Tunnel (
cloudflared) instead of LocalTunnel - Auto-installs
cloudflaredbinary if missing (Windows/Linux x64/arm64) - Tunnel creation retry + auto-reconnect on drop
- Safer defaults:
--confirm, auth/admin warning detection - Port policy controls:
--allowlist,--denylist - CLI UX modes:
--json,--quiet,--verbose,--copy - Diagnostics command:
portly doctor - Session commands:
portly list,portly stop - Watch mode:
portly watch - Preset aliases:
portly dev,portly demo - Local config support (
.portlyrc,.portlyrc.json,~/.portlyrc.json) - NPM helper script:
npm run share - Optional git hook installer:
npm run hooks:install
Install
npm install -g @solez-ai/portlyOr run instantly:
npx @solez-ai/portlyCore Commands
# Start tunnel
portly
# Manual port
portly 3000
# Watch mode
portly watch
# Diagnostics
portly doctor
# Sessions
portly list
portly stop
# Presets
portly dev
portly demoUseful Options
portly --json
portly --quiet
portly --verbose
portly --confirm
portly --copy
portly --allowlist 3000,5173
portly --denylist 9229
portly --copy
portly --no-reconnectConfig
Portly merges config from:
~/.portlyrc.json
./.portlyrc
./.portlyrc.jsonSupported keys include:
defaultPorttimeoutMsallowlistPortsdenylistPortsreconnectAttemptsreconnectDelayMs
Docs and Links
- Docs:
https://portly-live.pages.dev - GitHub:
https://github.com/Solez-ai/Portly - npm:
https://www.npmjs.com/package/@solez-ai/portly
Local Development
git clone https://github.com/Solez-ai/Portly.git
cd Portly/portly
npm install
npm run share
npm run docs:serveLicense
MIT License. See LICENSE.
