Repository navigation
Releases
GhostPort v0.1.1
Packaging release. GhostPort is now available on PyPI as ghostport-cli.
Changes
- PyPI distribution is named
ghostport-cli(the nameghostportis held by an unrelated project). The command and import name remainghostport. - 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
👻 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.0Inspect a local port:
ghostport inspect 8080Inspect its HTTP response:
ghostport inspect 8080 --httpCheck 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