hermes-wsl-terminal.yaml 2.0 KB

1234567891011121314151617181920212223242526272829303132333435
  1. name: hermes-wsl-terminal
  2. repo: https://github.com/Yicheng-Mark/hermes-windows-plugins
  3. sha: 5bad3fb2baf04ce6befecfefce6d14f4c9c98934
  4. subdir: wsl-terminal
  5. description: >-
  6. Run Hermes' terminal tools inside an existing WSL distro on Windows: one bash -c per
  7. command as the distro's default user, over the same files Windows sees at /mnt/<drive>, with
  8. no Docker Desktop, no image and no container to start or tear down. A host cwd is
  9. translated (C:\Users\me\proj becomes /mnt/c/Users/me/proj, \\wsl.localhost paths become the
  10. distro's own paths) and the mount root is asked once with wslpath, so a distro that moved
  11. its automount point still gets correct paths. cwd persists across commands, stdin and exit
  12. codes ride through wsl.exe, and hermes doctor / setup and the dashboard picker get real rows
  13. (wsl.exe path, WSL version, distros present, selected distro). HERMES_WSL_DISTRO and
  14. HERMES_WSL_USER select the distro and the user. Disclosure — this is a full-access backend,
  15. not a sandbox: when it is the selected backend, everything the terminal tool runs executes
  16. as your user inside your distro, with that distro's files, permissions and network access,
  17. so dangerous-command approval stays on and Hermes never stops the distro. The plugin itself
  18. reads no credentials, stores nothing and makes no network calls; it spawns wsl.exe per
  19. command and wslpath once per distro. It rewrites one core-produced string, the trailing cwd
  20. marker, because under WSL a command substitution is handed the directory wsl.exe started in
  21. rather than the shell's current one (measurements in the repo's VALIDATION.md); nothing in
  22. Hermes is patched or rebound at runtime.
  23. maintainer: Yicheng-Mark
  24. tier: community
  25. category: tools
  26. requires_hermes: ">=0.21.6"
  27. docs_url: https://github.com/Yicheng-Mark/hermes-windows-plugins/tree/main/wsl-terminal
  28. version: "0.1.0"
  29. platforms:
  30. - windows
  31. capabilities:
  32. provides_tools: []
  33. provides_hooks: []
  34. provides_middleware: []
  35. requires_env: []