Skip to content
Design System
GitHub

Command

v0.23.0

Search and run from the keyboard: a filterable list, and the ⌘K palette that opens over any page.

No robot, page or action matches. Try a robot ID such as 7F3A.

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

No robot matches.

Command with status

No robot, page or action matches “gate x”. Try a robot ID such as 7F3A.

Command no results

Command multi select

Nothing matches.

Command nested pages

Searching 30 days of events…

Command loading

No robot, page or action matches. Try a robot ID such as 7F3A.

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.

How to upgrade