All plugins

muse-harness

Drive local Muse Code over MSP so Wonder Full can call MCP tools. Disclosure — runs your locally installed muse (Muse Code) binary as a child process with an allowlisted environment and sends the prompt to Meta through it; if the Muse Code subscription allowance is exhausted, the same prompt is retried once on pay-as-you-go billing with the Meta API key stored in Hermes secrets (MODEL_API_KEY, META_API_KEY or META_MODEL_API_KEY) when one is set; with approval_mode: allowAll Muse runs its own shell and file tools in the session directory without asking; MCP servers the model passes are limited to loopback HTTP.

SnoobieJunes2Toolsv0.1.4Updated 17 days ago

About

Drive local Muse Code over MSP so Wonder Full can call MCP tools. Disclosure — runs your locally installed muse (Muse Code) binary as a child process with an allowlisted environment and sends the prompt to Meta through it; if the Muse Code subscription allowance is exhausted, the same prompt is retried once on pay-as-you-go billing with the Meta API key stored in Hermes secrets (MODEL_API_KEY, META_API_KEY or META_MODEL_API_KEY) when one is set; with approval_mode: allowAll Muse runs its own shell and file tools in the session directory without asking; MCP servers the model passes are limited to loopback HTTP.

muse-harness

Hermes plugin that drives a local Muse Code session over MSP (muse serve). Wonder Full stays inside the Muse harness. Hermes starts the turn, can attach a loopback MCP server (Unreal), and reads the result back.

This is not a model provider. It does not mint a subscription key, does not read Muse's login files, and does not call api.meta.ai itself.

Read DISCLAIMER.md before installing.

Billing

Subscription first. The first attempt does not pass an API key, so Muse uses the browser login. If the turn fails with MSP's typed error.quota object, the same prompt is retried once on pay-as-you-go. The key comes from Hermes secrets via agent.secret_scope.get_secret, in order: MODEL_API_KEY, META_API_KEY, META_MODEL_API_KEY. It is not read from the process environment. The child process receives an allowlist (PATH, HOME, USER, LANG, LC_*, TMPDIR, XDG_*) plus META_API_KEY on that retry only. The result field billing is subscription or api_key_fallback.

MUSE_CODE_SUB_TOKEN is never forwarded.

Install

hermes plugins install SnoobieJunes/hermes-muse-harness
hermes plugins enable muse-harness

Requires muse on PATH and muse login already completed. Tool approval comes from plugins.entries.muse-harness.settings.approval_mode.

Slash command

/muse <prompt> runs the same turn. /muse with no prompt prints the current approval mode.

Tool

muse_turn

ArgumentDefaultMeaning
promptrequiredThe turn text.
modelmuse-wonder-full-1.0Model id Muse should run.
workspacesession cwdMust stay inside the session directory.
mcp_serversnoneLoopback HTTP only. Example below.
timeout_s600Max 1200.
{"unreal":{"transport":"streamableHttp","url":"http://127.0.0.1:8000/mcp"}}

Contributor mode is forced off.

What this does not do

  • It does not put Wonder Full in Hermes's own inference loop.
  • It does not accept a model-supplied shell command as an MCP server.
  • It does not log you in. Run muse login yourself.

Development

python3 -m unittest discover -s tests -v
hermes plugins validate . --install-deps

A live echo check is python3 tests/live_echo.py on a machine that has muse.

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

More by SnoobieJunes

2 plugins by SnoobieJunes in the catalog.

SnoobieJuneswow-addon-forgeBuilds World of Warcraft: Forever (client 1.60.1, Interface 16001) addons that load and run, for players who are not programmers. Nine tools: wow_env (install/addon detection), wow_api (queryable index of the real client build's API, events and restrictions), wow_check (six-stage static + headless verification: TOC lint, Lua 5.1 syntax, global resolution, restricted/secret API rules, headless load in an embedded Lua 5.1 VM stub of the game, efficiency lints), wow_test (multi-client headless Lua test runner), wow_new (scaffolds an addon from tested building blocks: core, replicated record log, guild sync, trust, lazy Classic-theme window, Discord bridge), wow_install (installs after wow_check passes, with backup), wow_savedvars and wow_errors (read game data and in-game Lua errors back, via the bundled ForgeProbe companion addon), and wow_bridge (file-based Discord seam: pull an outbox, push an inbox, one /reload of latency each way). Ships Guildhall, a guild-management addon built entirely with these tools (board, calendar, a Marks currency earned automatically by playing, Discord mirror), the wow-addon-builder skill, /wow, hermes wow, and an Addon Forge Desktop pane. Disclosure — runs addon and test Lua code you point it at inside an embedded Lua 5.1 VM (lupa, a native extension) on your machine; wow_api sync downloads public API documentation from raw.githubusercontent.com; reads your WoW install (Interface/AddOns, WTF SavedVariables, .build.info); wow_install replaces Interface/AddOns/<name> after backing the old folder up under the Hermes cache, wow_bridge push rewrites that addon's Inbox.lua, and wow_new creates a new addon folder at the path given.Communitygeneral1

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section