rea.run

2026-10-16

Hermes Agent REA plugin: MCP + skill without editing config.yaml

Official Hermes Agent REA plugin art from Teknium’s announcement: mechanical gear tablet, assembly overlay, OFFICIAL PLUGIN / REA / Nous Research.
Public attachment from @Teknium status 2110736682207355062 (2026-10-15), also used as the plugin banner in NousResearch/hermes-official-plugins. Hosted on rea.run (1200×600).

On 2026-10-15T14:16:55Z, Teknium (@Teknium — cofounder / lead engineer, Hermes Agent @NousResearch) announced an official Hermes Agent plugin that ships the REA MCP plus a Skill for using it more effectively. Docs: hermes-agent.nousresearch.com/docs/plugins/rea. This rea.run page is the operator guide: install steps, pins, tool counts, wait budgets, and the disclosure list — not a remix of viral “most dangerous repo” framing. Chinese: /zh/blog/hermes-agent-rea-plugin/.

Why this page exists

Hermes users previously had to wire REA by hand (npx rea-agents setup --client hermes or a manual mcp_servers block). The official plugin is a portable Agent Plugins v1 package (mcp.json + skills/) from the Nous catalog. One install registers a pinned [email protected] stdio server and loads an adapted reverse-engineer-anything skill. Primary SEO phrases this page targets: Hermes REA, Hermes Agent REA plugin, REA MCP Hermes.

Official REA plugin banner / Teknium announcement art (OFFICIAL PLUGIN · REA · Nous Research).
Official REA plugin banner / Teknium announcement art (OFFICIAL PLUGIN · REA · Nous Research).

Sourced snapshots

X metrics and GitHub stars move. Values below are labeled snapshots from 2026-10-16 (UTC+8 lab) unless a row names another timestamp.

ItemValueSource
Announcementstatus 2110736682207355062@Teknium
Created2026-10-15T14:16:55ZPost timestamp
Impressions81802X API snapshot
Likes1671Same
Reposts151Same
Bookmarks1712Same
Replies92Same
Quotes37Same
Docs pageplugins/reaHermes docs
Added to catalog2026-10-15Docs “added” line
Plugin packageNousResearch/hermes-official-plugins /reaGitHub
Official-plugins repo stars293GitHub API 2026-10-16
Official-plugins forks31Same
Official-plugins licenseMITSame
Catalog PRhermes-agent#138225 merged 2026-10-15T02:45:02ZGitHub
Docs “pinned commit” label69ea758Docs page
Catalog pin called out in PR discussion3a102d9a387983e9c95bf84379d08fa2492b1de8PR #138225
Requires Hermes≥0.22.0 (docs); PR text also cites ≥0.22.1 for deadline supportDocs + PR
Plugin version0.1.0plugin.json
MCP pinnpx -y [email protected] mcpmcp.json
Ghidra startup envREA_GHIDRA_STARTUP_TIMEOUT_MS=900000 (900 s)mcp.json
Tools advertisedAbout 170 from REA 6.4.0Plugin README / docs
Schema bulk~460 KB (kept behind on-demand tool search)Plugin README
MCP prompts6Plugin README
Catalog card “★” on docs by-author page287 (page copy; repo API showed 293 stars same day — treat as separate UI counter)Docs listing

Arithmetic on the X snapshot only: bookmarks minus likes = 1712 − 1671 = 41 (saved slightly more often than liked in this snapshot). Do not invent engagement rates beyond that.

What one install ships

PiecePath / behaviorOperator note
MCP servermcp.json → stdio npx -y [email protected] mcpNo mcp_servers edit in config.yaml
Skillskills/reverse-engineer-anything/Adapted for Hermes tool search; asks before mutating steps
EnvREA_GHIDRA_STARTUP_TIMEOUT_MS=900000Large native imports
TierOfficial (NousResearch)Catalog + docs
PlatformsLinux, macOS, WindowsDocs
LicenseMIT (plugin + upstream REA attribution)rea/LICENSE
{
  "mcpServers": {
    "rea": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "[email protected]", "mcp"],
      "env": { "REA_GHIDRA_STARTUP_TIMEOUT_MS": "900000" }
    }
  }
}

The JSON above is the public mcp.json shape (schema agent-plugins.org 1.0.0). Prefer installing from the catalog rather than hand-copying forever — catalog re-pins are reviewed.

Narrow docs open-graph strip for the Hermes REA plugin catalog page.
Narrow docs open-graph strip for the Hermes REA plugin catalog page.

Install checklist

  1. Confirm Hermes ≥0.22.0 (prefer ≥0.22.1 if you need the published per-server deadline story from PR #138225).
  2. Put Node.js 22.19+ / 24.11+ / 26+ on PATH with npx. Docs: Node 23 and 25 are unsupported for REA.
  3. Install and enable:
  4. ```bash
  5. hermes plugins install rea
  6. hermes plugins enable rea
  7. ```
  8. Start a new Hermes session after enable (old sessions will not see the MCP server).
  9. Ask with an absolute path you are allowed to inspect, e.g. inspect an app you own and explain one feature.
  10. For native decompilation, BYO Ghidra+JDK, Hopper, or IDA. JADX/Java for Android code; Binwalk/Unblob for firmware; TShark / sigrok / WABT for their formats. REA does not install engines; the skill tells the agent not to either.
  11. Do not also run npx rea-agents setup --client hermes — that writes mcp_servers.rea into config.yaml and replaces this plugin’s pinned server.

Capability vs wait-budget table

LaneWorks with plugin alone?ExtraWait / size notes from upstream
Static JS / Electron / ASARYesNode pin onlySchemas ~460 KB behind tool search
Archives, Go/Rust metadata, PE resources, .NET metadata, saved HARYes—Read-mostly
Native decompileNeeds engineGhidra/Hopper/IDADefault Hermes MCP deadline 300 s; Ghidra startup budget 900 s via env
Per-server 1000 s Hermes call budgetNeeds newer HermesDocs: declare with v0.23.0; PR cites support from 0.22.1 packagingRead both docs + PR before planning long jobs
Android codeNeeds JADX + JavaDevice lane separateADB mutators are disclosed
Firmware extractBinwalk/Unblob—BYO
pcap / signals / WASMTShark / sigrok / WABT—BYO

Native timing examples (upstream observations — one Linux host)

Plugin README (WinSCP 6.7, static, never launched):

ObservationSecondsCaveat
Console launcher import~30One host
GUI executable with 1000 s Hermes budget663 (exceeded upstream 330 s default)Needs the longer budget path
Real Hermes chat first query (same native target)580Follow-ups succeeded
Procedures recovered (both runs)28701Not a guarantee for your binary

Treat these as cited observations, not SLAs. Pseudocode is decompiler output, not original source — cross-check consequential claims with assembly and references.

Tool naming and discovery

About 170 tools from REA 6.4.0 appear as mcp__rea__<tool> (mcp__rea__open_binary, mcp__rea__analyze_function, mcp__rea__analyze_javascript_application, mcp__rea__inspect_android_package, …). Hermes keeps them behind on-demand tool search so the visible tool list stays small. Six MCP prompts remain available through the server’s prompt tools. Community list timing for 6.4.0 (139→170 tools) lives on /blog/rea-linux-startup-benchmarks/ — that discussion does not measure Hermes plugin latency.

Disclosure: tools that run or change something

Most REA tools only read paths you name. Hermes does not prompt before the following; the bundled skill tells the agent to ask first and to skip them in unattended runs:

Tool familyRisk
capture_process_scenarioRuns a chosen command under a PTY
capture_browser_scenario / capture_electron_scenario / capture_native_ui_scenarioLaunch or drive an application window
install_adb_package / uninstall_adb_package / push_adb_file / start_adb_app / start_adb_activity / stop_adb_appChange a connected Android device
export_evidence_bundle / close_binaryMay overwrite a path you supply

Analyse untrusted programs in an environment you chose. Docs: REA sends no telemetry; network use is for the target you point at (debug endpoint, device, or source maps a browser capture fetches).

Version pinning policy

KnobPolicy
npm package[email protected] (published 2026-10-11) — @latest deliberately unused
SkillFrom the same REA release tag, adapted for Hermes
BumpsCommit in hermes-official-plugins + reviewed catalog SHA bump
ConflictManual rea-agents setup --client hermes replaces plugin pin — avoid

When rea.run teaching pages mention 6.5.0, that is a site pin for other clients (/blog/rea-agents-6-5-0/). This Hermes plugin’s public mcp.json still pins 6.4.0 until Nous re-pins. Do not “helpfully” edit the plugin to @latest.

Tone note on the quoted viral post

Teknium’s announcement quotes a separate viral article post that uses “most dangerous” marketing language. Operators should keep Evidence, authorization, and BYO engines as the primary story. Stars and impressions are discovery only (/blog/evaluating-rea-claims/). This page does not repeat crack-style promises.

Operator FAQ

QuestionShort answer
Command to install?hermes plugins install rea then hermes plugins enable rea
Must I edit config.yaml?No — plugin owns MCP registration
Can I also run REA setup for hermes?No — it replaces the pin
Node lines?22.19+ / 24.11+ / 26+; not 23/25
How many tools?About 170 (REA 6.4.0)
Is Ghidra included?No — BYO
Hermes minimum?Docs ≥0.22.0; prefer 0.22.1+ per catalog PR
Where is the skill from?Adapted REA reverse-engineer-anything

Compliance

  • Authorized / own / open / clean-room targets only (/compliance/, /faq/legal-boundary/).
  • Official install sources: Hermes catalog + npm [email protected] + vendor engines. No repacks or cracks.
  • Mutating capture/ADB/export tools need a human in the loop — especially unattended jobs.
  • rea.run is a community guide (low-key footer disclaimer). Not affiliated with Nous Research, Teknium, or morluto.
  • Images under /media/blog/hermes-rea/ are public announcement / docs / repo banner assets.

Sources

Related on rea.run

TopicURL
What is REA/blog/what-is-rea-reverse-engineer-anything/
6.4.0 operator guide/blog/rea-agents-6-4-0/
Client matrix/docs/clients/
MCP clients/docs/mcp-clients/
Security posture/blog/rea-agent-security-posture/
Open Claude UI case (same day)/blog/open-claude-ui-rea-case/