From 8fca0235f896a02a1a277350a636ab96886ca404 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Tue, 25 Aug 2026 02:04:12 +0000 Subject: [PATCH] docs(TSP-1416): add command palette documentation for Builder Add new page documenting the Cmd+K command palette in the Builder app, including quick actions, navigation/resource search, project switching, smart ordering (frecency), keyboard navigation, and tiered result scoring. Update Chat intro keyboard shortcuts FAQ to note the different Cmd+K behavior in Builder, and add a Builder CMD+K subsection to the project switching page. Co-Authored-By: Claude Sonnet 4.6 --- admin/project-management/switch-projects.mdx | 6 ++ docs.json | 6 ++ get-started/builder/command-palette.mdx | 87 ++++++++++++++++++++ get-started/chat/introduction.mdx | 2 + 4 files changed, 101 insertions(+) create mode 100644 get-started/builder/command-palette.mdx diff --git a/admin/project-management/switch-projects.mdx b/admin/project-management/switch-projects.mdx index 77a7e219..54a54e4a 100644 --- a/admin/project-management/switch-projects.mdx +++ b/admin/project-management/switch-projects.mdx @@ -19,6 +19,12 @@ To switch projects in the Builder platform: When you switch projects, you'll have access to all the tools, agents, and resources available in that project. +### Using the command palette + +You can also switch projects in the Builder using the command palette. Press `Cmd+K` (Mac) or `Ctrl+K` (Windows/Linux) to open it, then type a project name to search across all your projects, including those in other regions. Select a result to switch immediately. + +If you're currently viewing a page that exists in the destination project (for example, an Agent page), the Builder will try to land you on the same page type after switching. For more details, see [Command palette](/get-started/builder/command-palette). + ## Switching projects in Chat
diff --git a/docs.json b/docs.json index 2391efd5..186253fc 100644 --- a/docs.json +++ b/docs.json @@ -69,6 +69,12 @@ } ] }, + { + "group": "Builder", + "pages": [ + "get-started/builder/command-palette" + ] + }, { "group": "Marketplace", "pages": [ diff --git a/get-started/builder/command-palette.mdx b/get-started/builder/command-palette.mdx new file mode 100644 index 00000000..1c2ea2ca --- /dev/null +++ b/get-started/builder/command-palette.mdx @@ -0,0 +1,87 @@ +--- +title: "Command palette" +sidebarTitle: "Command palette" +description: "Keyboard-first access to navigation, actions, and resources anywhere in the Builder" +--- + + +The command palette is rolling out gradually and is currently gated behind the `cmd-k-spotlight` feature flag. + + +The command palette gives you keyboard-first access to navigation, actions, and resources from anywhere in the Builder. Press `Cmd+K` on Mac or `Ctrl+K` on Windows and Linux to open it. + +**Send a message to Invent** is always pinned at the top of the palette. + +## What you can do + + + + Create agents, tools, workforces, and knowledge tables, or open docs, copy the current URL, and contact support + + + Find any page in the Builder instantly by typing its name + + + Jump directly to any agent, tool, workforce, or knowledge set in your project + + + Type a project name to switch to another project across any region + + + +## Quick actions + +The following actions are available in the palette: + +- **Create tool** — open the tool creation flow +- **Create agent** — open the agent creation flow +- **Create workforce** — open the workforce creation flow +- **Create knowledge table** — open the knowledge table creation flow +- **Open docs** — go to the Relevance AI documentation +- **Copy URL** — copy the current page URL to your clipboard +- **Contact support** — open a support request + + +Contact support replaces the old Cmd+K support drawer that previously opened in the Builder. + + +## Navigation search + +Type any page name to find it in the Builder. Results appear as you type, with matched characters highlighted. Select a result to navigate directly to that page. + +## Resource search + +Type the name of an agent, tool, workforce, or knowledge set to jump to it directly. Resource results are mixed with navigation results and ranked by relevance. + +## Project switching + +Type a project name to search across all your projects, including projects in other regions. Select a result to switch to that project immediately. + +If you're on a page that exists in the destination project — for example, viewing an Agent — the palette will try to land you on the same page type after switching. + +## Smart ordering + +When the palette opens with no query, results are ranked by frecency: a combination of how recently and how frequently you've accessed each item. Items you use often appear near the top. The frecency score uses a 14-day half-life decay, so recent activity has more weight than older usage. + +## Keyboard navigation + +| Action | Shortcut | +|--------|----------| +| Open palette | `Cmd+K` (Mac) / `Ctrl+K` (Windows/Linux) | +| Navigate results | Arrow keys `↑` / `↓` | +| Select result by position | Number keys `1`–`9` | +| Clear query | `Esc` | +| Close palette | `Esc` (when query is already empty) | + +Pressing `Esc` clears the current query first. Pressing it again when the query is empty closes the palette. + +## How results are ranked + +The palette uses tiered scoring to match your query against result names: + +1. Exact match +2. Prefix match — query matches the start of the result +3. Acronym match — query matches the initials of a multi-word result +4. Fuzzy match — characters in the query appear in order within the result + +Matched characters are highlighted in each result so you can see why it was returned. diff --git a/get-started/chat/introduction.mdx b/get-started/chat/introduction.mdx index 4354cb00..c1096a17 100644 --- a/get-started/chat/introduction.mdx +++ b/get-started/chat/introduction.mdx @@ -191,6 +191,8 @@ File export is not supported for organizations in the AU region. | Toggle left panel (chat history) | Cmd+\ | Ctrl+\ | | Toggle right panel (Super GTM) | Cmd+B | Ctrl+B | | Switch projects | Cmd+K | Ctrl+K | + + In the Builder, `Cmd+K` / `Ctrl+K` opens the [command palette](/get-started/builder/command-palette) instead of switching projects directly. You'll be able to select the project you want to use Chat on in the bottom left. You'll be able to use all of the Agents you have access to in this project. If you want to access Agents in another project, you'll need to switch to that project in the bottom left. Not at this time, but we hope to add this feature soon!