Command
v0.23.0Search and run from the keyboard: a filterable list, and the ⌘K palette that opens over any page.
Command inline
Install
npx shadcn add @syncrobotic/command Also installs: cmdk, radix-ui, lucide-react, @syncrobotic/cn
Overview
When to use
- The app's search for robots, pages and actions (AppShell
search). - Picking from a long list by typing.
Use something else
- Filtering a list on the page as you type: Input group with a search icon.
- A few options: Select.
More examples
States and real uses. Each example is also a Storybook story and a visual regression test.
Command palette
Command with status
Command no results
Command multi select
Command nested pages
Command loading
Command recent
Command shortcuts
Command descriptions
Command destructive
Usage rules
- One palette per tool, opened by ⌘K / Ctrl+K and by the search field in the top bar (AppShell
search). - Group results by kind (robots, pages, actions) and show a detail on the right, such as the robot's state.
- The empty state says what was searched and what to try, not just “No results”.
Changelog
- 0.23.02026-11-20Every word it says can be translated without editing the source: CommandDialog takes
labels(title,description); the props of the same names still work and win. - 0.17.32026-11-19The highlighted row's ring appears only after keyboard use: at rest (a static list) there is none; it was a regression in 0.17.2.
- 0.17.22026-11-19A comment says where keyboard focus shows instead of the removed outline (no change in behaviour); checked by lint:rules. With the keyboard, the selected row shows a 2 px inset ring. CommandDialog gives focus back to what had it before it opened (button or ⌘K); it fell to the page. An inline Command no longer scrolls the page to itself as it mounts: cmdk keeps the highlighted row in view with scrollIntoView, which also moved the page; rows now scroll their own list only.