debugging-hermes-tui-commands

Diagnose Hermes TUI slash command mismatches across Python registry, gateway, and Ink frontend.

Updated May 5, 2026
One-click install
npx skills add https://github.com/Z43L/zeus-agent --skill debugging-hermes-tui-commands-z43l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-hermes-tui-commands
Source: https://github.com/Z43L/zeus-agent/tree/main/skills/software-development/debugging-hermes-tui-commands
Command: npx skills add https://github.com/Z43L/zeus-agent --skill debugging-hermes-tui-commands-z43l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It resolves broken or missing Hermes TUI slash commands by identifying and correcting synchronization issues between the Python command registry, the TUI gateway dispatcher, and the Ink/TypeScript frontend.

Core Features & Use Cases

  • End-to-end command-layer diagnosis: Pinpoints whether a command issue is caused by frontend registration, backend registry, or gateway dispatch gaps.
  • Autocomplete and dispatch consistency checks: Ensures command definitions appear in TUI autocomplete and actually execute with the expected handlers.
  • Live UI state debugging for persisted configs: Addresses cases where configuration is saved but the TUI does not reflect changes immediately.

Quick Start

Ask Zeus Agent to debug why a specific Hermes TUI slash command is not showing in autocomplete or is not executing by checking Python COMMAND_REGISTRY, the tui_gateway slash dispatch, and the ui-tui slash handler implementation, then propose the exact cross-layer fix steps.

Frequently Asked Questions about debugging-hermes-tui-commands

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

FAQPage Schema
Why are my Hermes TUI slash commands missing from autocomplete?

Hermes TUI slash commands go missing from autocomplete when command definitions are mismatched across the Python COMMAND_REGISTRY, the TUI gateway dispatcher, and the Ink frontend. Validating the registry as the canonical source and checking frontend handler registration resolves the inconsistency.

How do I debug slash commands that appear in the TUI but fail to execute?

Debugging non-executing slash commands involves verifying that the TUI gateway dispatches the known command and that the Ink frontend handler fallthrough routes to the correct handler with consistent arguments and category metadata, bridging the Python backend to the TypeScript UI.

What causes Hermes TUI configuration changes to save but not update the live UI?

Live UI state debugging addresses cases where persisted configurations are saved correctly but the Hermes TUI fails to reflect changes immediately, requiring validation of frontend state synchronization and command handler updates across the Ink TypeScript layer.

How does command registry synchronization work between Python and TypeScript in Hermes TUI?

Command registry synchronization works by treating the Python COMMAND_REGISTRY as the canonical source, ensuring the gateway JSON-RPC dispatches known commands, and verifying the Ink TypeScript frontend handlers match the registered aliases, subcommands, and category metadata.

Do I need to update the command registry when adding new slash commands to the TUI?

Adding new slash commands requires updating the Python COMMAND_REGISTRY first, then confirming the TUI gateway recognizes the new command for dispatch, and finally verifying the Ink frontend handler implements the execution logic and autocomplete entries correctly.

What's the best way to fix inconsistent slash command behavior between the CLI and TUI?

Fixing inconsistent slash command behavior between CLI and TUI requires an end-to-end command-layer diagnosis that checks the Python registry definitions, gateway dispatch coverage, and frontend handler fallthrough to ensure the correct handler executes with consistent arguments.