excrtx-hermes-extensions

Implements slash commands and direct tool calls in the Hermes Agent CLI and Gateway.

1|Updated May 26, 2026
One-click install
npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-hermes-extensions-elderbernardi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: excrtx-hermes-extensions
Source: https://github.com/elderbernardi/exocortex.saas/tree/main/skills/excrtx-hermes-extensions
Command: npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-hermes-extensions-elderbernardi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding a new slash command to the Hermes Agent often fails silently: the command works in the CLI but is treated as a normal message in the Telegram/Discord Gateway because the dispatch logic lives in multiple independent locations. This Skill guides developers through every required registration point so commands work in both CLI and Gateway, and shows how to call tools directly without spending LLM tokens. ## Core Features & Use Cases - Slash Command Registration: Step-by-step edits to commands.py (COMMAND_REGISTRY and ACTIVE_SESSION_BYPASS_COMMANDS), cli.py (process_command handler), and gateway/run.py (both the main dispatch chain and _DEDICATED_HANDLERS). - Direct Tool Calls (LLM Bypass): Invoke tools via handle_function_call from tools/model_tools.py without consuming LLM tokens. - Custom Tool Creation: Register new tools with the Hermes tool registry using schema and handler definitions. - Use Case: You create a /status_servidor command that works in the terminal but is treated as a normal message in Telegram. This Skill diagnoses the missing dispatch in the gateway main chain and tells you exactly where to add it. ## Quick Start Ask the agent to add a new slash command to the Hermes Agent that works in both the CLI and the Telegram Gateway, including all required dispatch registrations.

Frequently Asked Questions about excrtx-hermes-extensions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a slash command to the Hermes Agent?▼

Register a CommandDef in COMMAND_REGISTRY in commands.py, add an elif branch in cli.py's process_command method, and add dispatch in gateway/run.py in both the main chain and _DEDICATED_HANDLERS. Restart the CLI and Gateway afterward.

How to call a Hermes tool directly without using the LLM?▼

Import handle_function_call from tools/model_tools.py and pass the function name, arguments, and a tool_call_id. The handler must return a JSON string, which you parse with json.loads.

Why does my slash command work in the CLI but not in Telegram?▼

The Gateway has two independent dispatch chains in gateway/run.py. If the command is missing from the main dispatch chain (~line 8136), it falls through as a normal message to the agent. Add the dispatch in both the main chain and _DEDICATED_HANDLERS.

How do I make a slash command work while the agent is running?▼

Add the command name to the ACTIVE_SESSION_BYPASS_COMMANDS frozenset in commands.py and add its dispatch inside the _DEDICATED_HANDLERS block in gateway/run.py. The frozenset is immutable, so edit the source definition directly.

When should I not use this Hermes extension approach?▼

Do not use it for general MCP tool development, tool governance and classification, or persona-level behavior changes. Those belong to dedicated tool-development, governance, and behavior-canvas workflows instead.