From 7fc0cedf156c7298351660f4651a1b5e219ddbbe Mon Sep 17 00:00:00 2001 From: Tim Kmecl Date: Tue, 11 Apr 2023 16:34:13 +0200 Subject: [PATCH] docs --- README.md | 111 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 57 insertions(+), 54 deletions(-) diff --git a/README.md b/README.md index 5928b19..3f9f157 100644 --- a/README.md +++ b/README.md @@ -44,61 +44,9 @@ To use this extension, install it from the VSCode marketplace. After completing these steps, the extension should be ready to use. -### Obtaining API key - -To use this extension, you will need an API key from OpenAI. To obtain one, follow these steps: - -1. Go to [OpenAI's website](https://platform.openai.com/account/api-keys). If you don't have an account, you will need to create one or sign up using your Google or Microsoft account. -2. Click on the `Create new secret key` button. -3. Copy the key and paste it into the `API Key` field in the extension settings. - -### Settings - -The extension can be configured or customized by changing several settings. -You can choose **between ChatGPT and GPT4** by changing the `Model` setting (only if you already have access to GPT4 API). A custom API URL can also be set in the `API URL` field (probably looks something like `https://openai.xxxxxx.net/v1`, can be used to connect to a self-hosted instance of the API or a proxy). - - - -## Using the Extension - -To use the extension, open a text editor in Visual Studio Code and open the ChatGPT panel by clicking on the ChatGPT icon in the sidebar. This will open a panel with an input field where you can enter your prompt or question. By clicking enter, it will be sent to ChatGPT. Its response will be displayed below the input field in the sidebar (note that it may take some time for it to be calculated). - -Writing new code using chatGPT - -You can also select a code snippet in the editor and then enter a prompt in the side panel, or right-click and select "Ask ChatGPT". The **selected code will be automatically appended** to your query when it is sent to the AI. This can be useful for generating code snippets or getting explanations for specific pieces of code. - -Refactoring selected code using chatGPT - -To **insert a code snippet** from the AI's response into the editor, simply click on the code block in the panel. The code will be automatically inserted at the cursor position in the active editor. - -chatGPT explaining selected code - -You can select some code in the editor, right click on it and choose one of the following **shortcuts** from the context menu: -#### Commands: -- `Ask ChatGPT`: will provide a prompt for you to enter any query -- `ChatGPT: Explain selection`: will explain what the selected code does -- `ChatGPT: Refactor selection`: will try to refactor the selected code -- `ChatGPT: Find problems`: looks for problems/errors in the selected code, fixes and explains them -- `ChatGPT: Optimize selection`: tries to optimize the selected code - -`Ask ChatGPT` is also available when nothing is selected. For the other four commands, you can **customize the exact prompt** that will be sent to the AI by editing the extension settings in VSCode Preferences. - -Because ChatGPT is a conversational AI, you can ask follow-up questions to the response. The conversation context is maintained between queries, so you can ask multiple questions in a row (this can be disabled in the extension settings.). -If you aren't satisfied with an answer and would like to **retry the request**, click `ctrl+shift+p` and select `Retry ChatGPT request`. To **reset the conversation context**, click `ctrl+shift+p` and select `ChatGPT: Reset Conversation`. - ---- - -Please note that this extension is currently a proof of concept and may have some limitations or bugs. We welcome feedback and contributions to improve the extension. Also check out [CodeGPT](https://github.com/timkmecl/codegpt) extension that uses official OpenAI API and also supports other GPT3 models. -If you enjoy this extension, please consider [buying me a coffee ☕️](https://www.buymeacoffee.com/timkmecl) to support my work! - - -Buy Me A Coffee - - - - -## Building from source (not applicable for VSCode marketplace version) +
+Building from source (not applicable for VSCode marketplace version) To build the extension from source, clone the repository and run `npm install` to install the dependencies. You have to change some code in `chatgpt` module because VSCode runtime does not support `fetch`. Open `node_modules/chatgpt/dist/index.js` and add the following code at the top of the file: @@ -150,6 +98,61 @@ and line 4 to type FetchFn = any; ``` +
+ + + +### Obtaining API key + +To use this extension, you will need an API key from OpenAI. To obtain one, follow these steps: + +1. Go to [OpenAI's website](https://platform.openai.com/account/api-keys). If you don't have an account, you will need to create one or sign up using your Google or Microsoft account. +2. Click on the `Create new secret key` button. +3. Copy the key and paste it into the `API Key` field in the extension settings. + +### Settings + +The extension can be configured or customized by changing several settings. +You can choose **between ChatGPT and GPT4** by changing the `Model` setting (only if you already have access to GPT4 API). A custom API URL can also be set in the `API URL` field (probably looks something like `https://openai.xxxxxx.net/v1`, can be used to connect to a self-hosted instance of the API or a proxy). + + + + +## Using the Extension + +To use the extension, open a text editor in Visual Studio Code and open the ChatGPT panel by clicking on the ChatGPT icon in the sidebar. This will open a panel with an input field where you can enter your prompt or question. By clicking enter, it will be sent to ChatGPT. Its response will be displayed below the input field in the sidebar (note that it may take some time for it to be calculated). + +Writing new code using chatGPT + +You can also select a code snippet in the editor and then enter a prompt in the side panel, or right-click and select "Ask ChatGPT". The **selected code will be automatically appended** to your query when it is sent to the AI. This can be useful for generating code snippets or getting explanations for specific pieces of code. + +Refactoring selected code using chatGPT + +To **insert a code snippet** from the AI's response into the editor, simply click on the code block in the panel. The code will be automatically inserted at the cursor position in the active editor. + +chatGPT explaining selected code + +You can select some code in the editor, right click on it and choose one of the following **shortcuts** from the context menu: +#### Commands: +- `Ask ChatGPT`: will provide a prompt for you to enter any query +- `ChatGPT: Explain selection`: will explain what the selected code does +- `ChatGPT: Refactor selection`: will try to refactor the selected code +- `ChatGPT: Find problems`: looks for problems/errors in the selected code, fixes and explains them +- `ChatGPT: Optimize selection`: tries to optimize the selected code + +`Ask ChatGPT` is also available when nothing is selected. For the other four commands, you can **customize the exact prompt** that will be sent to the AI by editing the extension settings in VSCode Preferences. + + +Because ChatGPT is a conversational AI, you can ask follow-up questions to the response. The conversation context is maintained between queries, so you can ask multiple questions in a row (this can be disabled in the extension settings.). +If you aren't satisfied with an answer and would like to **retry the request**, click `ctrl+shift+p` and select `Retry ChatGPT request`. To **reset the conversation context**, click `ctrl+shift+p` and select `ChatGPT: Reset Conversation`. + +--- + +Please note that this extension is currently a proof of concept and may have some limitations or bugs. We welcome feedback and contributions to improve the extension. Also check out [CodeGPT](https://github.com/timkmecl/codegpt) extension that uses official OpenAI API and also supports other GPT3 models. +If you enjoy this extension, please consider [buying me a coffee ☕️](https://www.buymeacoffee.com/timkmecl) to support my work! + + +Buy Me A Coffee