# GhostRun: Hermes Agent plugin

> Recreate NES games as editable browser games.

Canonical: https://hermeswatcher.com/plugins/ghostrun  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/ghostrun  
Last updated in catalog: 2026-11-14

Recreate NES games as editable browser games. Train an AI player, rebuild levels and gameplay in Three.js, and add optional 3D visuals.

## Good to know before installing

`ghostrun_engine_setup` clones https://github.com/hbofz/NeSLE.git at a pinned commit and compiles it locally with nvcc/c++; runs git, nvcc, c++, nvidia-smi, ffprobe and the configured Python, including the agent-edited per-game reward module, outside the sandbox with a reduced environment that excludes provider keys; starts long-running background processes only on explicit tool calls (GPU training, an oracle service on a local Unix socket that can replay a checkpoint from the game's own runs folder, and a watcher that starts with every training run, checks every minute by default and can wake the agent to edit that game's reward reader and restart its training, max 3 fixes per game); reads the ROM path you give it and writes rebuilt games to ~/ghostrun-projects by default; a pre_tool_call hook blocks builder sessions from reaching the reference game. No credentials, no telemetry, no bundled binaries.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install ghostrun
```

2. Said no? Turn it on later:

```bash
hermes plugins enable ghostrun
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Images, video, music & 3D, Web, research & browsing
- Maintained by: kdcyberdude (Community)
- Needs: No API keys declared
- Adds tools: `ghostrun_init`, `ghostrun_policy_check`, `ghostrun_recreation_check`, `ghostrun_reward_check`, `ghostrun_reward_audit`, `ghostrun_reward_lint`, `ghostrun_reward_balance`, `ghostrun_reward_search`, `ghostrun_engine_setup`, `ghostrun_engine_parity`, `ghostrun_train_start`, `ghostrun_train_stop`, `ghostrun_train_check`, `ghostrun_fix_begin`, `ghostrun_fix_validate`, `ghostrun_fix_apply`, `ghostrun_fix_review`, `ghostrun_assets_import`, `ghostrun_status`, `ghostrun_stage_set`, `ghostrun_isolation_check`, `ghostrun_compare`, `ghostrun_gate`, `ghostrun_reference_enter`, `ghostrun_builder_enter`, `ghostrun_oracle_start`, `ghostrun_oracle_stop`, `ghostrun_oracle_call`, `ghostrun_watch_start`, `ghostrun_watch_stop`
- Works on: linux
- Requires Hermes: `>=0.23.0`
- Version: 0.3.1
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/ghostrun)
- [Source code](https://github.com/kdcyberdude/ghostrun#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
