debugging-bmb-tui-commands

Debug Hermes TUI slash command failures across Python registry, JSON-RPC gateway, and Ink/TypeScript frontend.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resolves cases where Hermes slash commands behave inconsistently across the Python command registry, the TUI gateway JSON-RPC bridge, and the Ink/TypeScript frontend—such as missing autocomplete entries, commands not dispatching, or UI state not updating after config changes.

Core Features & Use Cases

  • Tri-layer consistency debugging: Identify mismatches between Python COMMAND_REGISTRY, gateway dispatch (slash.exec/command.dispatch), and frontend local handlers.
  • Autocomplete diagnosis & repair: Ensure canonical command definitions and subcommands/aliases in bmb_cli/commands.py match what the TUI expects to show.
  • Live UI state troubleshooting: Confirm TUI-local commands update nanostore state immediately (not only persisted config), including cases where rendering paths diverge.

Quick Start

Use this skill to debug a command like /your-command that should appear in autocomplete and work in the Hermes TUI by checking whether it is defined in both bmb_cli/commands.py and the relevant frontend slash handler, and then validating the gateway dispatch handler matches the canonical name.

Frequently Asked Questions about debugging-bmb-tui-commands

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

FAQPage Schema
Why are my TUI slash commands missing from autocomplete or not dispatching correctly?

TUI slash command failures usually stem from mismatches between the Python command registry, the JSON-RPC gateway dispatch layer, and the Ink frontend handlers. Reconciling command definitions across all three layers restores missing autocomplete entries and correct dispatch behavior.

How do I debug slash commands that work in one interface but not another?

To debug inconsistent slash commands, validate canonical command and alias registration in the Python command registry, verify gateway known-command dispatch, and ensure frontend local state updates propagate through the correct rendering paths.

How do I fix TUI state not updating after a config change?

TUI state fails to update when frontend local handlers diverge from persisted config. Confirm TUI-local commands update nanostore state immediately through correct rendering paths, rather than relying solely on backend config propagation.

Does this debugging approach support JSON-RPC and Ink TypeScript frontends?

Yes, the debugging process specifically reconciles command definitions across Python registries, JSON-RPC gateway bridges, and Ink TypeScript frontend handlers. It validates that slash command definitions match what the TUI expects to show in autocomplete.

What is the best way to synchronize Python command registry definitions with TUI autocomplete?

The best way to synchronize autocomplete is ensuring canonical command definitions, subcommands, and aliases in the Python command file match the TUI gateway dispatch handler and frontend slash handler expectations across all layers.

How do I validate JSON-RPC gateway dispatch for slash commands?

Validate JSON-RPC gateway dispatch by checking that known-command dispatch handlers match the canonical command names defined in the Python registry, ensuring slash exec and command dispatch routes align with frontend handler expectations.