hermes-security.yaml 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. name: hermes-security
  2. repo: https://github.com/NousResearch/hermes-official-plugins
  3. sha: f211940dd81f32b85ec26e2e07de8aa5e24df9e0
  4. subdir: hermes-security
  5. title: Security
  6. description: 'Security review for a local repository. The agent builds a threat model, splits the code
  7. into chunks and reviews them with parallel subagents, checks each candidate against the code and
  8. traces whether an attacker can reach it. Reports keep evidence, rejected candidates and coverage
  9. gaps, export to Markdown, JSON, CSV and SARIF, and get a Security page in Hermes Desktop. Standard,
  10. deep and diff modes; `/security` slash command and `hermes security-review` CLI. Optional "Run tests
  11. to confirm findings" writes small reproductions and runs them in a temporary copy of the repository;
  12. testing a running app needs a per-scan grant (one origin, one hour, 200 requests) that agent tools
  13. cannot issue. Apache-2.0 (parts adapted from Apache-2.0 source, see NOTICE). Disclosure — the first
  14. scan downloads a pinned osv-scanner release from GitHub (about 55 MB, refused unless its SHA-256
  15. matches) into the plugin data folder; package names and versions go to api.osv.dev and api.deps.dev,
  16. declared runtime versions to endoflife.date (`HERMES_SECURITY_DEPENDENCY_CHECK=off` disables this).
  17. Test confirmation runs repository code as your user in a temporary copy with credential-looking
  18. environment variables removed; that is not a sandbox. The configured model provider receives the code
  19. under review; scan data stays in the profile''s plugin data folder. With
  20. `plugins.entries.hermes-security.allow_gateway_injection` turned on (off by default), the plugin
  21. queues one "Continue security scan" message into the chat when a scan stalls, at most 3 times without
  22. progress. No Python dependencies.'
  23. maintainer: NousResearch
  24. tier: official
  25. category: tools
  26. requires_hermes: ">=0.21.5"
  27. version: "0.1.0"
  28. image: https://raw.githubusercontent.com/NousResearch/hermes-official-plugins/f211940dd81f32b85ec26e2e07de8aa5e24df9e0/assets/hermes-security.jpg
  29. docs_url: https://github.com/NousResearch/hermes-official-plugins/tree/main/hermes-security
  30. platforms: []
  31. capabilities:
  32. provides_tools:
  33. - security_scan_start
  34. - security_scan_get
  35. - security_scan_checkpoint
  36. - security_scan_submit_worker_result
  37. - security_scan_record_validations
  38. - security_scan_record_chains
  39. - security_scan_finalize
  40. - security_scan_cancel
  41. - security_scan_export
  42. provides_hooks:
  43. - on_session_end
  44. - subagent_start
  45. - subagent_stop
  46. provides_middleware: []
  47. requires_env: []