randomwangran / mind-wave

Emacs AI plugin based on ChatGPT API

English | 简体中文

mind-wave

mind-wave is an Emacs AI plugin developed using ChatGPT API, which can be deeply integrated into Emacs to improve its efficiency in various aspects.

As mind-wave is developed based on multithreading technology, ChatGPT will not block Emacs during calculation.

Installation

1. Register OpenAI
2. Obtain OpenAI API Key, and save the API Key to the ~/.emacs.d/mind-wave/chatgpt_api_key.txt file (Or set the environment variable OPENAI_API_KEY.).
3. Install Python dependencies: pip3 install openai epc sexpdata six.
4. Install markdown-mode
5. Use git clone to download this repository and replace the load-path path in the configuration below.
6. Add the following code to your configuration file ~/.emacs:

(add-to-list 'load-path "<path-to-mind-wave>")

(require 'mind-wave)

Usage

Conversation Mode

1. Create a test.chat file to automatically enter mind-wave-chat-mode.
2. Execute the command mind-wave-chat-ask (press Ctrl + j), input your question, and wait for ChatGPT to respond.
3. Execute the command mind-wave-chat-continue (press Ctrl + u) to continue the conversation.
4. Execute the command mind-wave-chat-generate-title (press Ctrl + i) to generate a new title based on the content.

If you want to change the topic, create a new *.chat file and continue asking ChatGPT questions.

Multi-line Input

There are two ways of inputting multi-line content:

1. Execute the command mind-wave-chat-ask-with-multiline (press Ctrl + Shift + j), input multiple questions, and wait for ChatGPT to respond.
2. Execute the command mind-wave-chat-ask-insert-line to insert the ----- User ------ separator, continue inputting multiple lines in the buffer, and finally execute mind-wave-chat-ask-send-buffer.

Document mode

Selected Content:

1. Execute the command mind-wave-translate-to-english, ChatGPT will automatically replace the selected area with the translated content.
2. Execute the command mind-wave-proofreading-doc, ChatGPT will automatically replace the selected area with the polished document.

Code Refactoring Mode

Move the cursor to the desired function for refactoring.

1. Execute the command mind-wave-refactory-code, ChatGPT will automatically split the screen to display the refactored code and suggestions for improvement on the right.
2. Execute the command mind-wave-comment-code, ChatGPT will automatically split the screen to display code with comments on the right.
3. Execute the command mind-wave-explain-code, ChatGPT will automatically split the screen to display an explanation for the code on the right.

Summary Mode

1. Open a video website and execute the command mind-wave-summary-video. ChatGPT will automatically retrieve the video subtitles and analyze the summary of the video (YouTube Transcript API installation is required).
2. Open a text website and execute the command mind-wave-summary-web. ChatGPT will automatically retrieve the core content of the webpage and analyze the summary of the webpage (nodejs-readability-cli installation is required).

Feedback Issues

Please use the command emacs -q and only add the mind-wave configuration for comparison testing. If emacs -q can work properly, please check your personal configuration file.

If the problem still exists in the emacs -q environment, please submit an issue and attach the contents of the *mind-wave* window to help us troubleshoot. There are many clues there that can help us investigate the problem.

• If you encounter a crash, please collect the crash information using the following steps:
  1. Install gdb and enable the option (setq mind-wave-enable-debug t)
  2. Use the command mind-wave-restart-process to restart the MIND-WAVE process.
  3. Send the contents of *mind-wave* window when the next crash occurs.