Docs for Prompts and Prompt Library

docs/cody/capabilities/commands.mdx

@@ -1,6 +1,46 @@
-# Commands
+# Prompts and Commands
 
-<p className="subtitle">Learn how Commands can kick-start your workflow with reusable prompts.</p>
+<p className="subtitle">Learn how prompts and commands can kick-start your workflow.</p>
+
+## Prompts
+
+<Callout type="note">Prompts and Prompts Library are currently available in Cody's VS Code extension and the Sourcegraph Web UI.</Callout>
+
+Apart from these ready-to-use commands, you can create your own prompts from the **Prompt Library** via the Sourcegraph's Web UI. From here, you can easily create, edit, share, and discover prompts you’ve created or have been shared within your organization.
+
+## Prompt Library
+
+The Prompt Library can be accessed from the **Tools > Prompt Library** in the top navigation bar in Sourcegraph's web UI. From here, you can view, create or edit a prompt. You can also search for prompts, filter the list to find a specific prompt by owner, and sort by name or recently updated.
+
+![prompt-library-overview](https://storage.googleapis.com/sourcegraph-assets/Docs/prompt-library-overview-0824.png)
+
+### Create and edit a prompt
+
+Click the **New prompt** button on the **Prompt Library** page to create a new prompt.
+
+- Select the **Owner** and **Name** of the prompt
+- Then, write a prompt description
+- And finally, fill out the **Prompt template** box with all your prompt instructions
+- Moreover, you can mark your prompt as **Draft**. This would prevent it from being available to other users
+- Once done, click the **Create prompt** button
+
+Completing this process will do the following:
+
+- The new prompt will be added to the **Prompt Library** page
+- If it's not a draft, it will be available to other users in your organization
+- The prompt will start appearing via your connected Sourcegraph instance inside Cody's VS Code extension and the Sourcegraph Web UI
+
+![prompts-in-vscode](https://storage.googleapis.com/sourcegraph-assets/Docs/prompts-ui-vscode-082024.png)
+
+To edit a prompt, click the Edit button next to the prompt in the Prompt Library and make the necessary changes. You can also use this interface to **transfer ownership** of the prompt or delete it from this view.
+
+### Using prompts
+
+Prompts work in the same way as commands. Inside Cody's chat window there is a drop-down called **Prompts** next to the LLM selector. Use this to select a prompt and run on your codebase.
+
+![prompts-in-dropdown](https://storage.googleapis.com/sourcegraph-assets/Docs/using-prompts.png)
+
+## Commands
 
 Cody offers quick, ready-to-use **commands** for common actions to write, describe, fix, and smell code. These allow you to run predefined actions with smart context-fetching anywhere in the editor. Like autocomplete and chat, commands will search for context in your codebase to provide more contextually aware and informed answers.
 
@@ -31,9 +71,9 @@ The process of running a command varies from one IDE to another. For example, in
 
 ## Custom commands
 
-<Callout type="note">Custom Commands are in beta.</Callout>
+<Callout type="info">Custom Commands are currently in Beta and only supported in VS Code.</Callout>
 
-**Custom Commands** allow you to create and define reusable prompts for Cody tailored to your development workflows. They are defined in `JSON` format and will enable you to call CLI tools, write custom prompts, and select context to be sent to Cody. This provides a flexible way to configure Cody to handle use cases like:
+**Custom Commands** allow you to create and define reusable [Prompts](#prompts) for Cody tailored to your development workflows. They are defined in `JSON` format and will enable you to call CLI tools, write custom prompts, and select context to be sent to Cody. This provides a flexible way to configure Cody to handle use cases like:
 
 - Integrate with your build system to suggest fixes for errors/warnings in the latest build
 - Analyze software dependencies output to explain compatibility or suggest upgrades
@@ -74,7 +114,7 @@ If you select **User Settings**, the new custom command will only be available t
 
 See the [examples](#examples) and [configuration properties](#configuration-properties) below for more details on configuring custom commands.
 
-### Examples
+<Accordion title="Custom Commands Examples">
 
 ### `commit-message`
 
@@ -166,7 +206,9 @@ See the [examples](#examples) and [configuration properties](#configuration-prop
 }
 ```
 
-### Configuration properties
+</Accordion>
+
+<Accordion title="Configuration Properties">
 
 #### `commands` (required)
 
@@ -274,3 +316,7 @@ See the [examples](#examples) and [configuration properties](#configuration-prop
 You can define custom commands for Cody in the `cody.json` file. To make commands only available for a specific project, create the `cody.json` file in that project's `.vscode` directory. When you work on that project, these workspace-specific custom commands will be available.
 
 To make custom commands globally available across multiple projects, create a new `cody.json` file in your home directory's `.vscode` folder. These global custom commands will be available in Cody in any workspace. --> */}
+
+</Accordion>
+
+<Callout type="note">Commands and Custom Commands are soon going to be replaced by [Prompts](#prompts) and [Prompt Library](#prompt-library) in the coming future.</Callout>

docs/cody/clients/cody-with-sourcegraph.mdx

@@ -61,6 +61,6 @@ If Cody's answer isn't helpful, you can try asking again with a different contex
 
 ![re-run-prompts](https://storage.googleapis.com/sourcegraph-assets/Docs/rerun-prompt-web-0724.jpg)
 
-## Commands
+## Prompts
 
-Commands and Custom Commands are not supported in Cody for Web. If you want to run these, it's recommended that you use Cody with the IDE editor extensions (VS Code and JetBrains). However, the plain **Explain** command would work if you type `@mention explain this code` in the chat window.
+Prompts and the Prompt Library are supported in Cody for Web. You can access these from the **Prompts** selector drop-down in the chat interface. Read more about Prompts and the Prompt Library [here](/cody/capabilities/commands#custom-commands).

docs/cody/clients/feature-reference.mdx

@@ -60,6 +60,12 @@
 | Improve variable names         | ❌           | ❌             | ❌          | ✅       |
 | Ollama support (experimental)  | ✅           | ✅             | ❌          | ❌       |
 
+## Prompts and Prompt Library
+
+|             **Feature**              | **VS Code** | **JetBrains** | **Neovim** | **Web** |
+| ------------------------------------ | ----------- | ------------- | ---------- | ------- |
+| Access to prompts and prompt library | ✅           | ❌             | ❌          | ✅       |
+
   </Tab>
   <Tab title="Pro">
 
@@ -116,6 +122,12 @@
 | Improve variable names         | ❌           | ❌             | ❌          | ✅       |
 | Ollama support (experimental)  | ✅           | ✅             | ❌          | ❌       |
 
+## Prompts and Prompt Library
+
+|             **Feature**              | **VS Code** | **JetBrains** | **Neovim** | **Web** |
+| ------------------------------------ | ----------- | ------------- | ---------- | ------- |
+| Access to prompts and prompt library | ✅           | ❌             | ❌          | ✅       |
+
   </Tab>
     <Tab title="Enterprise">
 
@@ -136,14 +148,14 @@
 
 ### Context Selection
 
-|             **Feature**              | **VS Code** | **JetBrains** | **Neovim** | **Web** |
-| ------------------------------------ | ----------- | ------------- | ---------- | ------- |
-| Single-repo context                  | ✅           | ✅             | ✅          | ✅       |
-| Multi-repo context                   | ✅           | ✅             | ❌          | ✅       |
-| Local context                        | ✅           | ✅             | ❌          | ❌       |
-| Embeddings                           | ❌           | ❌             | ❌          | ❌       |
-| Guardrails                           | ✅           | ✅             | ❌          | ✅       |
-| Repo-based Cody Context Filters      | ✅           | ✅             | ❌          | ✅       |
+|           **Feature**           | **VS Code** | **JetBrains** | **Neovim** | **Web** |
+| ------------------------------- | ----------- | ------------- | ---------- | ------- |
+| Single-repo context             | ✅           | ✅             | ✅          | ✅       |
+| Multi-repo context              | ✅           | ✅             | ❌          | ✅       |
+| Local context                   | ✅           | ✅             | ❌          | ❌       |
+| Embeddings                      | ❌           | ❌             | ❌          | ❌       |
+| Guardrails                      | ✅           | ✅             | ❌          | ✅       |
+| Repo-based Cody Context Filters | ✅           | ✅             | ❌          | ✅       |
 
 
 
@@ -178,5 +190,11 @@
 | Improve variable names         | ❌           | ❌             | ❌          | ✅       |
 | Admin LLM selection            | ✅           | ✅             | ✅          | ✅       |
 
+## Prompts and Prompt Library
+
+|             **Feature**              | **VS Code** | **JetBrains** | **Neovim** | **Web** |
+| ------------------------------------ | ----------- | ------------- | ---------- | ------- |
+| Access to prompts and prompt library | ✅           | ❌             | ❌          | ✅       |
+
   </Tab>
 </Tabs>

docs/cody/clients/install-vscode.mdx

@@ -239,9 +239,9 @@ For repos mentioned in the `exclude` field, Cody's commands are disabled, and yo
 
 [Read more about the Cody Context Filters here →](/cody/capabilities/ignore-context)
 
-## Commands
+## Prompts and Commands
 
-Cody offers quick, ready-to-use [Commands](/cody/capabilities/commands) for common actions to write, describe, fix, and smell code. These allow you to run predefined actions with smart context-fetching anywhere in the editor, like:
+Cody offers quick, ready-to-use [Prompts and Commands](/cody/capabilities/commands) for common actions to write, describe, fix, and smell code. These allow you to run predefined actions with smart context-fetching anywhere in the editor, like:
 
 - **New Chat**: Ask Cody a question
 - **Document Code**: Add code documentation

docs/cody/index.mdx

@@ -45,8 +45,8 @@ Cody's main features include:
       <td>Ask Cody questions about code in the chat view, and it will use Sourcegraph’s code graph to answer using knowledge of your codebase</td>
     </tr>
     <tr>
-      <td><a href="cody/capabilities/commands">Commands</a></td>
-      <td>Cody offers quick ready-to-use commands for common actions, such as adding code documentation, generating unit tests, and detecting code smells</td>
+      <td><a href="cody/capabilities/commands">Prompts & Commands</a></td>
+      <td>Cody offers quick ready-to-use prompts for common actions, such as adding code documentation, generating unit tests, and detecting code smells</td>
     </tr>
     <tr>
       <td><a href="cody/capabilities/debug-code">Debug code</a></td>

docs/cody/quickstart.mdx

@@ -1,6 +1,6 @@
 # Cody Quickstart
 
-		<p className="subtitle">In this quickstart guide, you'll learn how to use Cody once you have installed the extension in your VS Code editor. Here you will perform the following three tasks:</p>
+<p className="subtitle">In this quickstart guide, you'll learn how to use Cody once you have installed the extension in your VS Code editor. Here you will perform the following three tasks:</p>
 
 1. Generate unit tests for your code
 2. Identify errors and get suggested code fixes
@@ -12,15 +12,15 @@
 - You have a Free or Pro account through Sourcegraph.com or a Sourcegraph Enterprise account
 - You have a project open in VS Code
 
-## Getting started with the Cody extension and commands
+## Getting started with the Cody extension, prompts, and commands
 
-After installing the extension, the side activity bar will display an icon for **Cody**. Click this icon, and Cody's panel will open. This interface is used to start a **New Chat**, run Cody **commands** or get access to relevant resources.
+After installing the extension, the side activity bar will display an icon for **Cody**. Click this icon, and Cody's panel will open. This interface is used to start a **New Chat**, run Cody **commands**, prompts or get access to relevant resources.
 
 ![Cody icon in side activity bar ](https://storage.googleapis.com/sourcegraph-assets/Docs/cody-sidebar-0724.jpg)
 
-Cody supports **Commands** with VS Code. These are quick, ready-to-use prompt actions that you can apply to any code or text-based snippet you've highlighted. You can run a command in the following ways:
+Cody supports **Prompts** and **Commands** with VS Code. These are quick, ready-to-use actions that you can apply to any code or text-based snippet you've highlighted. You can run a command in the following ways:
 
-- Highlight your code and select the command from the sidebar
+- Highlight your code and select the command or any prompt from the drop-down
 
 ![running-commands](https://storage.googleapis.com/sourcegraph-assets/Docs/using-commands-0724.jpg)
 

src/data/navigation.ts

@@ -47,8 +47,8 @@ export const navigation: NavigationItem[] = [
             subsections: [
               { title: "Chat", href: "/cody/capabilities/chat", },
               { title: "Autocomplete", href: "/cody/capabilities/autocomplete", },
-              { title: "Commands", href: "/cody/capabilities/commands", },
-              { title: "OpenCtx" , href: "/cody/capabilities/openctx", },
+              { title: "Prompts & Commands", href: "/cody/capabilities/commands", },
+              { title: "OpenCtx", href: "/cody/capabilities/openctx", },
               { title: "Debug Code", href: "/cody/capabilities/debug-code", },
               { title: "Context Filters", href: "/cody/capabilities/ignore-context", },
               { title: "Proxy Setup", href: "/cody/capabilities/proxy-setup", },