debugging-hermes-tui-commands

Diagnose and fix slash command issues across Hermes Python backend, gateway, and Ink TUI layers.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill debugging-hermes-tui-commands-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-hermes-tui-commands
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/software-development/debugging-hermes-tui-commands
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill debugging-hermes-tui-commands-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Slash commands in the Hermes TUI span three layers — the Python command registry, the tui_gateway JSON-RPC bridge, and the Ink/TypeScript frontend — and bugs occur when one layer falls out of sync with another, causing missing autocomplete entries, commands that work in CLI but not TUI, or config changes that don't apply live. ## Core Features & Use Cases - Cross-layer investigation workflow: Step-by-step search commands to locate command definitions in the Python COMMAND_REGISTRY, gateway handlers, and TUI frontend files. - Autocomplete and dispatch fixes: Concrete instructions for adding CommandDef entries, gateway handlers, and CLI process_command branches with correct cli_only/gateway flags. - Live UI state guidance: Explains how to patch nanostore state so config changes apply immediately across streaming and transcript render paths. - Use Case: A developer adds a new /details command that appears in the TUI but never shows in autocomplete; this skill walks them through registering it in COMMAND_REGISTRY, rebuilding the TUI, and verifying behavior end to end. ## Quick Start Ask the agent to debug why a specific Hermes slash command is missing from TUI autocomplete or behaves differently between the CLI and the TUI.

Frequently Asked Questions about debugging-hermes-tui-commands

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

FAQPage Schema
How do I fix a slash command missing from TUI autocomplete?

Add a CommandDef entry to COMMAND_REGISTRY in hermes_cli/commands.py with the correct category, aliases, and subcommands. Autocomplete data ships from Python, so the TUI cannot suggest commands absent from the registry.

Why does a slash command work in CLI but not in the TUI?

The command likely has a Python handler but no TUI-side handling. Check the local handler in ui-tui/src/app/createSlashHandler.ts and the gateway slash.exec dispatch; local Ink handlers take precedence over gateway fallthrough.

How do I add a new slash command to both backend and frontend?

Register a CommandDef in COMMAND_REGISTRY, add a handler in HermesCLI.process_command or gateway/run.py, and implement the frontend branch in the TUI slash commands. Then rebuild the TUI with npm --prefix ui-tui run build.

Why does a command save config but not update the TUI live?

Updating config.set alone is insufficient for TUI-local commands. You must also patch the relevant nanostore state via patchUiState and thread the new state through all render paths, including streaming and transcript views.

What is the difference between cli_only and gateway_only commands?

cli_only commands run only in the interactive CLI/TUI, while gateway_only commands are restricted to messaging platforms. Setting neither makes a command available everywhere, and gateway_config_gate can conditionally enable gateway availability.