Skip to content

[BUG] [v0.1.0] @ mention autocomplete provides minimal labels without clear usage guidance #51830

Description

@jony376

Project

cortex

Description

When users type @ in the input, the mention autocomplete list appears, but the item descriptions are very brief and do not explain what will happen after selection (for example, what exact data will be attached or how each mention type should be used).

This makes the feature harder to understand for first-time users because the list shows names and short phrases without enough contextual guidance.

Error Message

Debug Logs

System Information

OS: Windows 11 Pro 64-bit
CPU: Intel Core i7-8700
RAM: 16 GB
GPU: NVIDIA GeForce GTX 1050 (4 GB VRAM)

Screenshots

https://github.com/techforgeworks-sudo/images/blob/main/Screenshot_68.jpg

Steps to Reproduce

  1. Focus the input box.
  2. Type @ to open mention autocomplete.
  3. Review the descriptions shown for mention items (for example: file, folder, url, git, terminal).

Expected Behavior

Mention items should provide clearer, action-oriented guidance so users understand the result of selecting each item and how to use it effectively.

Actual Behavior

The mention list uses short static descriptions that are often too minimal to explain expected behavior or next steps.

Additional Context

The @ mention autocomplete path is handled in:

  • src/cortex-tui/src/runner/event_loop/input.rs (AutocompleteTrigger::Mention, then filter_mentions(query)).
  • src/cortex-tui/src/widgets/autocomplete.rs where mention metadata is hardcoded in MentionType::description() and converted into visible items via MentionType::to_item().

Metadata

Metadata

Assignees

No one assigned

    Labels

    invalidThis doesn't seem right

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions