docs(TSP-1416): add CMD+K command palette documentation

admin/project-management/switch-projects.mdx

@@ -9,7 +9,7 @@
 ## Switching projects in Builder
 
 <div style={{ width:"100%",position:"relative",paddingTop:"56.25%"}}>
 <iframe src="https://app.supademo.com/embed/cmleppoa403yszqp029cuiah2" frameBorder="0" title="Switching projects in Builder" allow="clipboard-write; fullscreen" webkitAllowFullscreen="true" mozAllowFullscreen="true" allowFullscreen style={{ position:"absolute",top:0,left:0,width:"100%",height:"100%",border:"3px solid #5E43CE",borderRadius:"10px" }} />
 </div>
 
 To switch projects in the Builder platform:
@@ -19,10 +19,16 @@
 
 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
 
 <div style={{ width:"100%",position:"relative",paddingTop:"56.25%"}}>
 <iframe src="https://app.supademo.com/embed/cmlepvnfd0437zqp07b72bjn5" frameBorder="0" title="Switching projects in Chat" allow="clipboard-write; fullscreen" webkitAllowFullscreen="true" mozAllowFullscreen="true" allowFullscreen style={{ position:"absolute",top:0,left:0,width:"100%",height:"100%",border:"3px solid #5E43CE",borderRadius:"10px" }} />
 </div>
 
 To switch projects in the Chat platform:

docs.json

@@ -69,6 +69,12 @@
                   }
                 ]
               },
+              {
+                "group": "Builder",
+                "pages": [
+                  "get-started/builder/command-palette"
+                ]
+              },
               {
                 "group": "Marketplace",
                 "pages": [

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"
+---
+
+<Note>
+The command palette is rolling out gradually and is currently gated behind the `cmd-k-spotlight` feature flag.
+</Note>
+
+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
+
+<CardGroup cols={2}>
+  <Card title="Quick actions" icon="bolt">
+    Create agents, tools, workforces, and knowledge tables, or open docs, copy the current URL, and contact support
+  </Card>
+  <Card title="Navigation search" icon="magnifying-glass">
+    Find any page in the Builder instantly by typing its name
+  </Card>
+  <Card title="Resource search" icon="layer-group">
+    Jump directly to any agent, tool, workforce, or knowledge set in your project
+  </Card>
+  <Card title="Project switching" icon="arrows-rotate">
+    Type a project name to switch to another project across any region
+  </Card>
+</CardGroup>
+
+## 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
+
+<Note>
+Contact support replaces the old Cmd+K support drawer that previously opened in the Builder.
+</Note>
+
+## 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.

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.
     </Accordion>
     <Accordion title="Which Agents will show up in Chat - all the Agents in my organization, or just the ones in a specific project?">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.</Accordion>
     <Accordion title="Can I call multiple Workforces in the same Chat?">Not at this time, but we hope to add this feature soon!</Accordion>