JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 34
  • Score
    100M100P100Q77376F
  • License MIT

Interactive TUI for active listening ports and process management (macOS)

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (portui) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    portui

    Interactive terminal UI for listening TCP ports on macOS (via lsof). Browse PIDs, processes, addresses, and users; filter and sort; kill processes with SIGTERM or SIGKILL; inspect process details; detect port conflicts.

    Requirements

    • macOS (uses lsof)

    Install

    From npm (Node.js 18+):

    npm install -g portui

    Or run without a global install:

    npx portui

    The first time you install a given version, the package downloads a prebuilt binary from GitHub Releases. Publish a matching vX.Y.Z tag and let the release workflow attach portui-darwin-arm64.tar.gz and portui-darwin-x64.tar.gz before publishing to npm.

    From source (Rust 1.70+):

    cargo install --path .
# or
cargo run --release

    Local npm development (use the binary you built with Cargo instead of downloading):

    cargo build --release
npm install

    Keys

    Key Action
    q / Esc Quit
    j / ↓, k / ↑ Move selection
    Enter / K Kill selected (y SIGTERM, f SIGKILL, n cancel)
    d / Tab Toggle details pane (parent PID, FDs, conns)
    w Toggle auto-refresh (2s interval)
    r Manual refresh
    s Cycle sort: port → pid → name
    / Filter (name, user, port, PID)
    g / Home, G / End Jump top / bottom
    ? Help overlay

    Features

    • Details pane (d/Tab) — shows port category, parent PID, open file descriptor count, and established connection count for the selected process
    • SIGTERM + SIGKILL — kill prompt offers graceful termination (y) or force kill (f)
    • Auto-refresh (w) — polls every 2 seconds by default; toggle on/off with w
    • Port conflict detection — ports with multiple processes listening are marked with ! in the table

    Build

    cargo build --release
# binary: target/release/portui