Skip to content

[UX] Quick commands not shown in /help output #4090

@SHL0MS

Description

@SHL0MS

Summary

User-defined quick_commands from config.yaml are functional (cli.py:3900-3924) but invisible in /help. The show_help() method (cli.py:2682-2713) iterates COMMANDS_BY_CATEGORY and _skill_commands but never reads self.config.get("quick_commands").

Users who configure quick commands have no way to discover them from within the TUI — they just have to remember what they set up.

Suggested fix

Add a section to show_help() after the skill commands block:

quick_commands = self.config.get("quick_commands", {})
if quick_commands:
    _cprint(f"\n  {_BOLD}── Quick Commands ──{_RST}")
    for name, qcmd in sorted(quick_commands.items()):
        desc = qcmd.get("description", qcmd.get("type", ""))
        ChatConsole().print(f"    [bold {_accent_hex()}]/{name:<15}[/] [dim]-[/] {_escape(desc)}")

Impact

  • Severity: Low — discoverability gap, not a functional bug
  • Risk: None — additive display only
  • Effort: Tiny — ~5 lines

Ref

UX audit item #4.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions