Skip to content

The agent that grows with you

feat(plugin-catalog): add hermes-windows-ports

Yicheng-Mark496a3e843533
diff --git a/plugin-catalog/hermes-windows-ports.yaml b/plugin-catalog/hermes-windows-ports.yaml
new file mode 100644
index 00000000000..a3ef0af3ba9
--- /dev/null
+++ b/plugin-catalog/hermes-windows-ports.yaml
@@ -0,0 +1,36 @@
+name: hermes-windows-ports
+repo: https://github.com/Yicheng-Mark/hermes-windows-ports
+sha: aa49f6a6b061c8ace8e8930b574e803b84ad8760
+description: >-
+ Answer "who holds this port" on Windows. win_port_owners reads the TCP and UDP owner
+ tables through iphlpapi (the same rows netstat -ano prints, with the owning PID attached)
+ and resolves each PID to its image name and path, returning structured JSON instead of
+ localized console output. Filters cover one port, several ports, a process substring, the
+ protocol (tcp, udp or both), the TCP state (listen, established, any state name, or all;
+ UDP rows report bound) and IPv6 inclusion, with a record cap and a per-process summary of
+ the rows returned. Built for the failure mode that stalls agents on Windows: a gateway,
+ backend or bridge that cannot bind, where the error names a port but not the process
+ holding it, and where parsing netstat breaks on a non-English machine because the headers
+ are localized. A protected process whose image cannot be queried keeps its PID and reports
+ a null process name instead of failing the call. Disclosure - the tool reports the local
+ and remote addresses, ports, PIDs and process image paths that netstat -ano and Task
+ Manager already show, and those values reach the model; treat the output like any other
+ local diagnostic listing. Read-only: no socket is opened, bound or connected, the only
+ process access is QueryFullProcessImageName with PROCESS_QUERY_LIMITED_INFORMATION to read
+ an image name, and there is no memory reading, no handle inheritance and no injection.
+ Stdlib-only (ctypes): no Python dependencies, no child processes, no network calls, no file
+ writes, no self-update. Windows only.
+maintainer: Yicheng-Mark
+tier: community
+category: tools
+requires_hermes: ">=0.21.4"
+docs_url: https://github.com/Yicheng-Mark/hermes-windows-ports#readme
+version: "0.1.0"
+platforms:
+- windows
+capabilities:
+ provides_tools:
+ - win_port_owners
+ provides_hooks: []
+ provides_middleware: []
+ requires_env: []