Command

1[dependencies]2gpui-kit = "0.6.6"34# command.rs builds on gpui-base primitives:5# InputState (editing) + ScrollHandle — no extra deps.

1# Download the runnable example crate, then:2cargo run --locked -- --command34# Other demos:5cargo run --locked -- --command shortcuts6cargo run --locked -- --command groups7cargo run --locked -- --command scrollable8cargo run --locked -- --command dialog

1use justdo_command::command::{Command, CommandItem, CommandSelectEvent};2use gpui_kit::base::input::InputState;34// The input entity is created with a Window, then the5// command entity wraps it and owns filtering + highlight.6let input = cx.new(|cx| {7    InputState::new(window, cx).placeholder("Type a command or search…")8});910let command = cx.new(|cx| {11    Command::new(input, cx)12        .items(vec![13            CommandItem::new("Calendar").group("Suggestions"),14            CommandItem::new("Profile")15                .group("Settings")16                .shortcut("⌘P")17                .icon(CommandIcon::User),18        ])19        .empty_text("No results found.")20});2122cx.subscribe(&command, |view, _, ev: &CommandSelectEvent, cx| {23    view.run_command(&ev.value);24    cx.notify();25});2627div().child(command)

1// Filtering is substring match over label, value, group2// and hidden keywords — items can expose extra match-only3// terms that never render:4CommandItem::new("Command Palette")5    .keywords(&["palette", "commands"])6    .shortcut("⇧⌘P")

1Command                   entity — input + list + active row2├── CommandInput          Entity<InputState> — real text editing (gpui-base)3│                         magnifier glyph, 44px row, bottom border4├── CommandList           filtered rows — scrollable (list_max_h)5│   ├── CommandGroup      heading per CommandItem::group(..)6│   ├── CommandSeparator  auto line between different groups7│   ├── CommandItem       icon + label + optional shortcut8│   │                     .value(..) .keywords(..) .disabled(..)9│   ├── CommandShortcut   trailing muted ⌘P / ⌘B / ⌘S10│   └── CommandEmpty      .empty_text(..) — no-match state11└── emits                 CommandSelectEvent { value }

1// Keyboard semantics ride GPUI's action system, not raw2// key capture. A focused single-line input registers no3// up/down handlers, so input::MoveUp / input::MoveDown4// bubble out — the command listens for them and moves the5// highlighted row (skipping disabled items).6//7// Enter propagates as input::Enter and commits the active8// row. Escape clears the query first; on an empty query it9// propagates so a CommandDialog host can close.