██████╗ ███████╗██╗   ██╗██████╗  ██████╗ ██████╗ ████████╗███████╗
██╔══██╗██╔════╝██║   ██║██╔══██╗██╔═══██╗██╔══██╗╚══██╔══╝██╔════╝
██║  ██║█████╗  ██║   ██║██████╔╝██║   ██║██████╔╝   ██║   ███████╗
██║  ██║██╔══╝  ╚██╗ ██╔╝██╔═══╝ ██║   ██║██╔══██╗   ██║   ╚════██║
██████╔╝███████╗ ╚████╔╝ ██║     ╚██████╔╝██║  ██║   ██║   ███████║
╚═════╝ ╚══════╝  ╚═══╝  ╚═╝      ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚══════╝

devports

A lightweight CLI for managing local development ports.

devports tracks configured local services, inspects live listeners, launches configured apps, opens running local apps in the browser, and prints LAN-friendly URLs when you want to reach those apps from another device.

Install

cargo install --git https://github.com/justyn-clark/devports

Other install paths:

• npm: npm i -g @justyn-clark/devports
• curl: curl -fsSL https://raw.githubusercontent.com/justyn-clark/devports/main/scripts/install.sh | bash
• Homebrew and Scoop instructions: docs/installation.md

Example config

services:
  web:
    repo: ~/projects/web
    port: 3000
    start: vite --host 0.0.0.0 --port 3000

Quickstart

devports config init

devports config add web \
  --repo ~/projects/web \
  --port 3000 \
  --start "vite --host 0.0.0.0 --port 3000"

devports start web
devports list
devports urls

devports start <service> launches the configured command in the background from the service repo and writes output to .devports/start.log.

devports open <service> opens the local app at http://127.0.0.1:<port>, but only when that configured service is actually listening.

devports urls is the LAN/share surface. It prints hostname-based URLs for configured services and does not change what open launches locally.

How To Use

1. Initialize the config.

devports config init

2. Add a service entry with a name, repo path, expected port, and start command.

devports config add web \
  --repo ~/projects/web \
  --port 3000 \
  --start "vite --host 0.0.0.0 --port 3000"

3. Launch the service.

devports start web

This returns immediately and prints the local URL, process ID, and log path. Service output is written to .devports/start.log inside the configured repo.

4. Open the running local app.

devports open web

This opens http://127.0.0.1:<port> only if that configured service is actually listening.

5. Inspect runtime state.

devports list
devports doctor
devports scan

• list joins live listeners with configured services
• doctor checks config quality and likely unmapped local dev listeners
• scan prints the raw listener records

6. Print LAN URLs when you want to open the app from another device.

devports urls
devports urls --host 192.168.1.50

If no services are configured, devports urls prints an explicit message instead of failing silently.

Real Example

For /Users/justin/Documents/Justyn Clark Network/REPOS/jcn-studio-mcp, the repo already defines a root dev script that runs the web app, and the Vite config sets port 4321. A working config entry for that project is:

devports config add jcn-studio-web \
  --repo "/Users/justin/Documents/Justyn Clark Network/REPOS/jcn-studio-mcp" \
  --port 4321 \
  --start "pnpm dev"

Commands

devports scan
devports list [--json]
devports tui
devports kill --port 3000 [--hard] [--timeout-ms 1500]
devports start <service>
devports doctor [--json]
devports urls [--host <host>]
devports open <service>
devports config path
devports config init [--force]
devports config add <name> --repo <path> --port <port> [--start <command>]

TUI controls

Arrows, Home/End, PageUp/PageDown  navigate listeners
o                                  open the selected local service URL
k / K                              graceful terminate / force kill
s                                  launch the selected configured service
r                                  rescan listeners
e                                  open the active config file
/                                  enter filter mode
?                                  show the full keyboard help
q                                  quit