About Chat

Chat is a new way to work with your codebase using natural language. Chat will automatically use the current workspace as context and you can provide focus for Augment by selecting specific code blocks, and @ including files that are particularly relevant.

Accessing Chat

Access the Chat sidebar by clicking the Augment icon in the sidebar. You can also open Chat by using one of the keyboard shortcuts below. If you do not see the Augment icon in your sidebar, Chat has not been enabled for your organization.

Keyboard Shortcuts

PlatformShortcut
MacOScmd + L
Windows/Linuxctrl + L

Using Chat

To use Chat, simply type your question or command into the input field at the bottom of the Chat panel. You will see the currently included context which includes the workspace and current file by default. For example, instead of browsing the folder structure in a Next.js project, you can ask Chat to tell you about all the valid routes in the project.

Conversations about code

To get the best possible results, you can go beyond asking simple questions or commands, and instead have a back and forth conversation with Chat about your code. For example, you can ask Chat to explain a specific function and then ask follow-up questions about possible refactoring options. Chat can act as a pair programmer, helping you work through a technical problem or understand unfamiliar code.

Starting a new chat

You should start a new Chat when you want to change the topic of the conversation since the current conversation is used as part of the context for your next question. To start a new chat, open the Chat panel and click the

icon at the top-right of the Chat panel.

Continuing a chat

You can continue a chat by clicking the chevron icon

at the top-left of the Chat panel. Your previous chats will be listed in reverse chronological order, and you can continue your conversation where you left off.

Deleting a chat

If you no longer need a previous chat, you can delete an existing chat by clicking the trash icon

.

Using code blocks from within Chat

Whenever Chat responds with code, you will notice that it will surface as a block that has actions for you to perform on it:

  • Copy the code from the block to your clipboard
  • Insert the code from the block where your cursor is in the editor window
  • Create a new file with the code from the block

Adding additional context

Adding 3rd party documentations into context is currently a beta feature and is only available to some users.

Augment intelligently includes context from your entire workspace based on the ongoing conversation–even if you don’t have the relevant files open in your editor–but sometimes you want Augment to prioritize specific details for more relevant responses.

You can add additional context to your conversation by highlighting code blocks, or using @ to mention files, folders, or documentation. The context dialog will appear as you type @ and you can use fuzzy search to quickly find the context you want to include. In the context dialog, you can exclude previously mentioned context by toggling the Visibility icon.

Mentioning files and folders

Include specific files or folders in your context by typing @ followed by the file or folder name. For example, @routes.tsx will include the routes.tsx file in your context. You can include multiple files or folders.

Mentioning 3rd party documentation

You can also mention 3rd party documentation in your context by typing @ followed by the name of the documentation. For example, @react will include React documentation in your context. Augment provides nearly 300 documentation sets spanning across a wide range of domains such as programming languages, packages, software tools, and frameworks.