All plugins

ghostbox

Speculative shadow-execution sandbox and blast-radius verifier for autonomous agent tools using ephemeral Git worktrees. Disclosure — creates git worktrees under <repo>/.hermes/ghostbox/, adds .hermes/ to the repo's .git/info/exclude, and its fast-forward commit tool applies the shadow worktree's changes to your checkout (paths checked against Hermes' write denylist).

arjunbagga-xyzToolsv0.1.0Updated 3 days ago

About

Speculative shadow-execution sandbox and blast-radius verifier for autonomous agent tools using ephemeral Git worktrees. Disclosure — creates git worktrees under <repo>/.hermes/ghostbox/, adds .hermes/ to the repo's .git/info/exclude, and its fast-forward commit tool applies the shadow worktree's changes to your checkout (paths checked against Hermes' write denylist).

Ghost-Box: Speculative Shadow Sandbox & Blast-Radius Verifier

Ghost-Box provides speculative execution sandboxing and diff verification for autonomous agents in Hermes.

Instead of running mutating commands directly on your live branch, Ghost-Box allows agents to spawn an ephemeral detached Git worktree (.hermes/ghostbox/<id>), make speculative changes, and compute a blast-radius report.

You see the exact files modified and lines changed directly in the Hermes Desktop chat transcript—then apply the changes with Fast-Forward Commit, or discard the shadow worktree with zero residue.


⚡ Core Features

  • Speculative Git Worktrees: Spawns isolated detached shadow worktrees (.hermes/ghostbox/<id>) in a git repository.
  • Blast-Radius Verification: Exact file counts, git diff analysis, and tree hashing before changes are applied to the workspace.
  • Fast-Forward Commit: Applies verified shadow diffs atomically to the workspace with destination write safety checks.
  • Hermes Desktop Directives: Transcript card (::ghostbox-card) with diff metrics and one-click actions.

🛠️ Provided Tools

  1. ghostbox_spawn_shadow(label): Spawns an ephemeral detached worktree.
  2. ghostbox_compute_blast(shadow_id): Generates blast-radius metrics and desktop card.
  3. ghostbox_fast_forward_commit(shadow_id): Merges shadow changes to the host workspace with write protection.
  4. ghostbox_discard_shadow(shadow_id): Safely discards and cleans up the shadow worktree.

💻 Desktop Directive

Renders natively in Hermes Desktop via ::ghostbox-card:

::ghostbox-card[shadow_id="shadow_7f8a" safety_score=98 files_changed=2 lines_added=24 lines_removed=6]

📄 License

MIT © 2026 Arjun Bagga

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

More by arjunbagga-xyz

7 plugins by arjunbagga-xyz in the catalog.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section