Skip to content

Search the Workspace

Search the workspace command palette across records, saved views, and runnable commands from any page in the shell.

Best for Human member Updated April 3, 2026
Web In this interface
4 steps Steps
1 interfaces Available in
Use this path when

The command palette builds one ranked result set from generic commands, visible records, and contextual actions derived from the best-matching records.

What you'll finish here
  • Search visible workspace records from a single input.
  • Use prefixes and keywords to narrow the result set.
  • Understand how ranking, favorites, and contextual actions shape the results.

Where this happens

LabelValueNotes
ComponentWorkspace command paletteGlobal workspace search and action surface.
EndpointGET /api/workspace/commandLoads searchable records and command permissions for the current viewer.

Do the work

  1. 1. Open the palette from any workspace page and start with the plainest terms you know: route name, task title, project key, team key, person name, username, label, or status.
  2. 2. Add `@`, `$`, or `#` only when the mixed result list is too broad and you want to force people, projects, or tasks.
  3. 3. Review Favorites, Actions, and record groups together. Exact and prefix matches rank highest, then broader keyword and synonym matches, with recent and favorited items boosted.
  4. 4. Choose a record to navigate or choose an action to mutate the matched item or open a prefilled create flow.

Keep this clear

  • Search indexes task titles, descriptions, references such as `TEAM-123`, team names and keys, project names and keys, assignee names, labels, statuses, and task comment text.
  • Projects, people, teams, drafts, and saved views also contribute their names, descriptions, ownership fields, usernames, emails, and scope metadata to the same result set.
  • Keyword expansion covers synonyms such as task or ticket, project or initiative, assign or owner, complete or done, progress or active, and draft or unpublished.
  • An empty query shows suggestions instead of a blank state, with Actions and Favorites weighted above the rest of the record set.
  • Contextual actions are generated only from the highest-ranked matching records, not from every record in the workspace.
  • Strict scopes still narrow the main result list to the chosen record type. For example, `@aj` returns people matches first, and the selected record can then open its actions menu with `Cmd/Ctrl+K`.
  • Keyboard navigation always follows the currently rendered filtered result order. Group headings are visual only and do not participate in selection.

Scope prefixes

LabelValueNotes
No prefixAll resultsSearches commands, favorites, records, and contextual actions together.
`@person`PeopleStrict people scope for the main result list. Secondary actions stay available from the selected record actions menu.
`$project`ProjectsStrict project scope for the main result list. Secondary actions stay available from the selected record actions menu.
`#task`TasksStrict task scope for the main result list. Secondary actions stay available from the selected record actions menu.

Indexed result sources

LabelValueNotes
TasksTitle, description, task reference, team, project, assignee, labels, status, commentsFavorite tasks are boosted and grouped under Favorites.
DraftsTitle, description, team, project, assignee, labels, statusDrafts are searchable separately from published tasks.
ProjectsName, key, summary, description, lead, members, labels, related team keys, status, priorityProject favorites are boosted and can also produce contextual actions.
PeopleName, username, email, title, bio, workspace role, team keysPeople scope is activated by the `@` prefix.
TeamsName, key, description, expertise areaTeam records can produce open and create-task actions.
ViewsName, description, owner, scope type, placementIncludes both task views and project views.
ActionsGeneric launchers plus contextual actions from the top matching recordsContextual actions inherit the matched record title and current state.

Keep Going in Search and Shortcuts

Stay in the same interface and move to the next closest task in this topic when needed.

Nearby Guides

These guides stay close to the current workflow so you can keep moving without restarting discovery.