Command

Overview

Copy the source into your project, then import the parts you need. Styles use local StyleX declarations and shared theme tokens. You can change the source without wrapping or replacing a package.

Installation

Run bunx @yopem-ui/cli init from your project root first. The CLI configures StyleX and installs shared files and dependencies.

bunx @yopem-ui/cli init

bunx @yopem-ui/cli add command

Run from your project root. The CLI installs required components, shared files, and packages. Previews may need additional components. Existing files are preserved. To refresh installed source, use update; locally edited files need an explicit --force to overwrite.

bunx @yopem-ui/cli update command

Preview

"use client"

import { Box } from "@registry/components/ui/box"
import { Button } from "@registry/components/ui/button"
import {

Usage

Compose CommandInput and CommandList with CommandItem controls inside Command. Use CommandEmpty for no matches.

Command is built on Autocomplete. Group results with CommandGroup and CommandGroupLabel. CommandShortcut displays a shortcut but does not register it.

For a command palette, place Command inside CommandDialogPopup under CommandDialog. The popup includes portal, backdrop and viewport; supply an accessible title or aria-label.

Import from the local file installed by the CLI.

"use client"

import {
  Command,
  CommandEmpty,
  CommandInput,
  CommandItem,
  CommandList,
  CommandPanel,
} from "@/components/ui/command"

export function Preview() {
  const items = [
    { label: "New project", value: "new-project" },
    { label: "Open settings", value: "settings" },
  ]

  return (
    <Command items={items}>
      <CommandInput
        aria-label="Search commands"
        placeholder="Search commands"
      />
      <CommandPanel>
        <CommandEmpty>No commands found.</CommandEmpty>
        <CommandList>
          {(item: { label: string; value: string }) => (
            <CommandItem
              key={item.value}
              value={item.value}
              onClick={() => window.alert(item.label)}
            >
              {item.label}
            </CommandItem>
          )}
        </CommandList>
      </CommandPanel>
    </Command>
  )
}

API reference

Generated from canonical TypeScript source. Only component and Base UI props appear below. Required marks a required property, not a required component.