Maru.ai VSCode Extension

This is the VSCode Extension to enables interactions with Maru.ai

Basic Usage

There are currently three methods for starting a chat with Maru.ai in this extension

• Click on the Maru.ai logo in the bottom right corner. This will open a new chat window.
• Use ctrl/cmd+shift+P to search for a command by name. Select "Start chat with Maru.ai".
• Select some text in the editor, right-click, and select "Ask Maru to explain this code".

Each tab opened to chat with Maru.ai is a new conversation. A conversation can have multiple turns and allows you to refine your conversation to get a better result.

Authentication

When you initially load the extension or when you existing session expires, you'll need to authenticate to use talk with Maru. You can start the authentication process by opening a new chat and clicking the "Start Authentication" button. This will begin an Oauth workflow called a Device Authorization Flow. This is used for internet connected devices (or applications in this case) that do not have a standard browser to complete authentication flows. Instead you will be prompted to open a link in your browser that has a Device Code. This same Device Code is displaed in the progress box in your IDE. You may need to log into your account if you are not already logged in. Then you'll grant access to the device/application. Once this step is completed you can close the browser and you'll notice that the IDE updates within a few seconds.

If you find that you need to manually clear your authentication tokens, you can use ctrl/cmd+shift+P and find the "Clear Maru.ai Authentication" command.

Organization And Project Scope

You can narrow the scope of your conversations with Maru by selecting an Organization and Project. The extension will default to "All Default Projects", which answers questions using all data in the organization's default project group. There are two ways to select your scopes.

• On a chat tab, use the "Organization" and "Project" selectors at the top of the chat and this will set the scopes used for the chat.
• Use ctrl/cmd+shift+P and find the "Select Maru.ai Defaults" command.