All plugins

sentinel-security

Scans scripts before the agent runs them and blocks, asks for approval, or allows them; also hashes files. Disclosure — reads script files referenced in terminal/execute_code tool calls and any path given to its tools (hash and pattern scan only, never executed or returned); appends an audit line (path, SHA-256, verdict) to plugin-data/sentinel-security/sentinel-audit.jsonl in your Hermes home; when a VT_API_KEY is configured, sends each scanned file's SHA-256 (never its contents) to www.virustotal.com, including from the pre-run guard before every flagged command.

CogkreatesToolsv1.1.1Updated 7 days ago

About

Scans scripts before the agent runs them and blocks, asks for approval, or allows them; also hashes files. Disclosure — reads script files referenced in terminal/execute_code tool calls and any path given to its tools (hash and pattern scan only, never executed or returned); appends an audit line (path, SHA-256, verdict) to plugin-data/sentinel-security/sentinel-audit.jsonl in your Hermes home; when a VT_API_KEY is configured, sends each scanned file's SHA-256 (never its contents) to www.virustotal.com, including from the pre-run guard before every flagged command.

Sentinel Security for Hermes Agent

Sentinel checks scripts before your agent runs them. When Hermes is about to execute a script through the terminal or execute_code tools, Sentinel scans it first and then lets it run, sends it to Hermes's approval gate, or blocks it.

What it does

PartHow it works
Pre-run guard (pre_tool_call hook)Finds script files in the command (.py .ps1 .bat .cmd .sh .js .vbs) and scans them. Clean: runs. Suspicious: sent to Hermes's human approval gate. Clearly malicious: blocked, and the model is told why.
analyze_file toolSHA-256 of a file plus a static scan, and a VirusTotal hash lookup when a VT_API_KEY is configured.
scan_script toolStatic scan for network calls, credential/wallet access, dynamic code execution, persistence, bulk deletion, env-var reads.
Audit logEvery guarded call is appended to plugin-data/sentinel-security/sentinel-audit.jsonl in the active Hermes home.

Verdict rules: credential access combined with network calls, or a high total score, is blocked. A moderate score goes to approval. Everything else is allowed.

Install

  1. Put this folder in your Hermes plugins directory (on Windows: C:\Users\<you>\AppData\Local\hermes\plugins\sentinel-security).
  2. hermes plugins enable sentinel-security
  3. Restart hermes and run /plugins to confirm it is loaded.

To turn the guard off, set plugins.entries.sentinel-security.settings.guard to off in config.yaml (default: on).

Disclosure

  • Network: only if a VT_API_KEY is configured. Then analyze_file and the guard send the file's SHA-256 hash (never the file contents) to virustotal.com. With no key, Sentinel makes no network calls.
  • Reads outside its own data: it reads the script files the agent is about to run (paths found in the tool call's arguments), and analyze_file / scan_script read the path you give them.
  • Writes: appends one JSON line per guarded call to plugin-data/sentinel-security/sentinel-audit.jsonl in the active Hermes home, so it follows the current profile (file path, SHA-256, verdict, findings).
  • Shell commands / background processes: none. Scripts are read, never executed.
  • Credentials: the optional VirusTotal key is read through Hermes's secret scope. Nothing is stored by the plugin.
  • Telemetry: none.
  • Approvals: Sentinel only returns block or approve to Hermes's own gate. It never auto-approves or disables any guard.

Limitations

  • The scan is static pattern matching. Determined obfuscation can evade it. Treat it as a first line of defense, not proof of safety.
  • It is not a sandbox. Nothing is isolated or executed.
  • It inspects scripts referenced by the terminal tool's command and inline code passed to execute_code. Other routes are not covered.

Roadmap

  • Honey-data sandbox: run suspicious scripts in isolation with fake credentials and watch for exfiltration.
  • Scan downloaded archives and installers.
  • Per-project allow and deny lists.

Tests

python test_sentinel.py

README from the reviewed commit 75bb23a; it updates when the author re-pins.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section