> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Command

> A keyboard-first search interface for finding and executing actions, navigating to pages, or looking up content across the application. Typically triggered by a keyboard shortcut (⌘K / Ctrl+K) and rendered inside a Dialog or Popover.

## Command

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-command--docs)

### When to use

* A power-user shortcut to access actions or destinations without navigating manually.
* Applications with a large number of actions or pages that would be impractical to surface all at once.
* When you want to support keyboard-driven workflows across the whole app.

### When not to use

* Filtering a specific list or dataset on the page — use [Search](/aura-design-system/primitives/search).
* Selecting from a known set of options in a form — use [Combobox](/aura-design-system/primitives/combobox) or [Select](/aura-design-system/primitives/select).
* Simple navigation between a small number of pages — use [Tabs](/aura-design-system/primitives/tabs) or nav links.

### Dos and don'ts

* Do group results into categories (actions, pages, recent, etc.) an ungrouped flat list becomes hard to scan quickly.
* Do use action verbs for command labels ("Open settings", "Create asset", "Switch to dark mode").
* Do show the keyboard shortcut on whatever triggers the command menu.
* Do show a meaningful empty state when no results match — "No results for..." is more helpful than a blank panel.
* Do show a loading state rather than leaving the list empty while fetching if results load asynchronously.
* Do show recent or frequently used items surfaced by default as they make the primitive significantly more useful.
* Don't use it as a general search input — it's for actions and navigation, not content retrieval.
* Don't include destructive actions without a confirmation step after selection.

### Often used with

* Host surface ([Dialog](/aura-design-system/primitives/dialog) or [Popover](/aura-design-system/primitives/popover)), search field row, result list with sections; [KBD](/aura-design-system/primitives/kbd) chord to open; optional [Empty state](/aura-design-system/primitives/empty-state) when no matches.