feat(tui): implement @ reference picker overlay and / slash command overlay #10164

Open
opened 2026-04-17 04:03:11 +00:00 by HAL9000 · 0 comments
Owner

Background

The @ reference picker and / slash command overlay are triggered by prefix characters in the PromptInput. The reference picker provides file, actor, and resource completion with fuzzy search, while the slash command overlay shows available commands with filtering. Both overlays must appear above the input and dismiss on selection or escape.

Acceptance Criteria

  • @ prefix triggers reference picker overlay with file/actor/resource completion
  • / prefix triggers slash command overlay with fuzzy search filtering
  • Both overlays dismiss on selection (inserts text) or escape (cancels)
  • Reference picker shows file paths relative to project root
  • Slash command overlay shows command descriptions
  • Test coverage >= 97%

Metadata

  • Commit Message: feat(tui): implement @ reference picker and / slash command overlays
  • Branch: feature/v3.7.0/tui-reference-command-overlays
  • Milestone: v3.7.0
  • Ref: #5305 EPIC: TUI Reference & Command Input System — @, /, ! Mode Parsing (v3.7.0)

Subtasks

  • Implement ReferencePickerOverlay widget with file/actor/resource completion
  • Implement SlashCommandOverlay widget with fuzzy search
  • Implement prefix detection in PromptInput to trigger overlays
  • Implement overlay dismissal on selection and escape
  • Write unit tests for overlay triggering and selection

Definition of Done

  • Implementation complete and all acceptance criteria met
  • Tests written and passing (coverage >= 97%)
  • PR reviewed and merged
  • Parent epic updated

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor

## Background The `@` reference picker and `/` slash command overlay are triggered by prefix characters in the PromptInput. The reference picker provides file, actor, and resource completion with fuzzy search, while the slash command overlay shows available commands with filtering. Both overlays must appear above the input and dismiss on selection or escape. ## Acceptance Criteria - [ ] `@` prefix triggers reference picker overlay with file/actor/resource completion - [ ] `/` prefix triggers slash command overlay with fuzzy search filtering - [ ] Both overlays dismiss on selection (inserts text) or `escape` (cancels) - [ ] Reference picker shows file paths relative to project root - [ ] Slash command overlay shows command descriptions - [ ] Test coverage >= 97% ## Metadata - **Commit Message**: `feat(tui): implement @ reference picker and / slash command overlays` - **Branch**: `feature/v3.7.0/tui-reference-command-overlays` - **Milestone**: v3.7.0 - **Ref**: #5305 EPIC: TUI Reference & Command Input System — @, /, ! Mode Parsing (v3.7.0) ## Subtasks - [ ] Implement `ReferencePickerOverlay` widget with file/actor/resource completion - [ ] Implement `SlashCommandOverlay` widget with fuzzy search - [ ] Implement prefix detection in `PromptInput` to trigger overlays - [ ] Implement overlay dismissal on selection and escape - [ ] Write unit tests for overlay triggering and selection ## Definition of Done - Implementation complete and all acceptance criteria met - Tests written and passing (coverage >= 97%) - PR reviewed and merged - Parent epic updated --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#10164
No description provided.