Hermes Agent integration for WasmBox tool discovery
README.md

wasmbox-hermes #

Hermes Agent integration for WasmBox tool discovery and execution.

Status: Early exploration β€” mapping WasmBox's agent-first tool protocol to Hermes Agent's skill system.

What This Is #

WasmBox is a Flatpak-style launcher for sandboxed WebAssembly tools. Every tool ships with machine-readable agent metadata β€” prompts, modes, flags, examples, exit codes.

Hermes Agent is an AI agent framework with a skill system (SKILL.md files) that teaches agents how to use tools.

This project bridges them: auto-discover installed WasmBox tools as native Hermes skills.

How It Works #

wasmbox install jfmt
  ↓
wasmbox info jfmt --json
  ↓ (structured agent metadata)
wasmbox-hermes discovers tool
  ↓
Generates Hermes SKILL.md
  ↓
Agent can now use: wasmbox run jfmt -- <flags>

Architecture #

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  WasmBox     β”‚     β”‚ wasmbox-     β”‚     β”‚   Hermes     β”‚
β”‚  Registry    │────▢│ hermes       │────▢│   Agent      β”‚
β”‚  (tools)     β”‚     β”‚ (bridge)     β”‚     β”‚   (skills)   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
     .wasm              discovers           uses tools
     .json              + generates         via skills
     .md                SKILL.md files

Goals #

Tool Metadata β†’ Skill Mapping #

WasmBox Manifest Hermes SKILL.md
agent.prompt Skill description / instructions
agent.modes[] Usage examples + flag documentation
agent.exit_codes Error handling guidance
name + version Skill name + version
description Skill frontmatter description
capabilities Security notes in skill body

Quick Start #

# Prerequisites
cargo install --git https://tangled.org/metaend.eth.xyz/wasmbox-cli wasmbox-cli --locked
wasmbox registry add https://qstorage.quilibrium.com/wasmbox
wasmbox install jfmt compact b64 secretscan --allow-all

# Generate Hermes skills from installed WasmBox tools
python3 bridge.py discover
python3 bridge.py generate

License #

MIT

Credits #