Skip to content

Releases

GhostPort v0.1.1

Choose a tag to compare

@cyberthreed cyberthreed released this 11 Nov 08:36

Packaging release. GhostPort is now available on PyPI as ghostport-cli.

Changes

  • PyPI distribution is named ghostport-cli (the name ghostport is held by an unrelated project). The command and import name remain ghostport.
  • Added a GitHub Actions workflow that publishes to PyPI with Trusted Publishing (OIDC), with no long-lived tokens.
  • Updated install instructions and documentation.

No functional changes from v0.1.0.

Install

python -m pip install ghostport-cli

Requires Python 3.11+. Tested on Windows, Linux, and macOS.

GhostPort v0.1.0

Choose a tag to compare

@cyberthreed cyberthreed released this 11 Nov 08:14

👻 GhostPort v0.1.0 | First Transmission

The ghost has entered localhost.

Introducing GhostPort, the first public release of a lightweight port diagnostic utility from CyberStudios™.

Built for developers who have ever stared at an occupied port and wondered what, exactly, was answering on the other end.

GhostPort investigates local TCP connections, identifies listening processes when possible, and inspects HTTP responses without downloading response bodies.

No cloud services. No background daemon. No unnecessary complexity.

Just practical diagnostics from your terminal.

✦ What's Included

Local TCP inspection

Check whether a port accepts connections on IPv4 or IPv6 loopback.

Process identification

Discover the associated PID and process name when operating-system permissions allow.

HTTP diagnostics

Inspect response status, content type, server information, and timing.

JSON response validation

Check whether a service advertises a supported JSON media type.

Structured output

Generate versioned JSON reports for scripts and automated workflows.

Privacy-conscious operation

Localhost-only networking, read-only process inspection, bounded HTTP requests, no telemetry, and sensitive-value redaction.

🖥️ Quick Start

Requires Python 3.11+.

python -m pip install git+https://github.com/CyberStudiosTM/GhostPort.git@v0.1.0

Inspect a local port:

ghostport inspect 8080

Inspect its HTTP response:

ghostport inspect 8080 --http

Check for JSON:

ghostport inspect 8080 --http --expect-json

🧪 Validation

The initial release candidate passed:

  • 60 local automated tests.
  • Ruff lint and formatting checks.
  • Live localhost smoke tests.
  • All nine GitHub Actions jobs across Windows, Ubuntu, and macOS on Python 3.11, 3.12, and 3.13.

☁️ Known Limitations

Process identification depends on operating-system permissions. Closed loopback connections may take approximately two seconds to report on Windows.

GhostPort does not scan remote hosts, identify services conclusively, inspect HTTP response bodies, or modify running processes.

See the README for full documentation.

✿ From CyberStudios™

GhostPort is part of the CyberStudios™ ecosystem: independent creative and developer tools built with an emphasis on thoughtful design, practical functionality, and reliable engineering.

This is the first transmission.

Welcome to GhostPort. 👻

[Source Code](https://github.com/CyberStudiosTM/GhostPort) · [Documentation](https://github.com/CyberStudiosTM/GhostPort#readme) · [Report an Issue](https://github.com/CyberStudiosTM/GhostPort/issues)

License: MIT