hermes-windows-process.yaml 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. name: hermes-windows-process
  2. repo: https://github.com/Yicheng-Mark/hermes-windows-plugins
  3. sha: 5bad3fb2baf04ce6befecfefce6d14f4c9c98934
  4. subdir: windows-process
  5. description: >-
  6. Answer "what is still running, and who started it" on Windows: win_process_table reads the
  7. process table (PID, parent PID, image name) and adds each process's image path and creation
  8. time, then marks every row with whether its recorded parent is still the process that spawned
  9. it. Windows stores a parent PID rather than a handle, so a child that outlived its parent
  10. points at a PID that is either unused or reused by a newer process; a parent that started
  11. after its child cannot have spawned it, so both cases are reported as gone or reused instead
  12. of a plausible but wrong parent name. Filters cover one PID, several PIDs, a name or path
  13. substring, a parent PID, and an orphans-only view of what outlived its parent, with a result
  14. cap and an option to leave out Windows session processes. Use it for leftover
  15. gateway/backend/server children after a quit, for telling thirty python.exe rows apart by
  16. start time, and for checking whether a process started before or after the thing being
  17. debugged. Read-only: processes are opened with PROCESS_QUERY_LIMITED_INFORMATION for
  18. QueryFullProcessImageName and GetProcessTimes only - no memory reads (command lines are
  19. deliberately out of scope), no handle duplication, no writes, no child processes. Stdlib-only
  20. (ctypes): no Python dependencies, no network calls, no file writes, no self-update. Windows
  21. only. Disclosure - the tool reports image names, image paths and start times to the model,
  22. and those routinely include the user and machine name (C:\Users\<name>\...) and reveal which
  23. editor, shell or agent started which process; treat the output like a Task Manager
  24. screenshot.
  25. maintainer: Yicheng-Mark
  26. tier: community
  27. category: tools
  28. requires_hermes: ">=0.21.4"
  29. docs_url: https://github.com/Yicheng-Mark/hermes-windows-plugins/tree/main/windows-process
  30. version: "0.1.0"
  31. platforms:
  32. - windows
  33. capabilities:
  34. provides_tools:
  35. - win_process_table
  36. provides_hooks: []
  37. provides_middleware: []
  38. requires_env: []