Package: gshellx
READMEGShellX 💻A Python-based CLI app powered by OpenAI's GPT-3.5-turbo model to generate responses to user prompts, with a specific focus on generating shell commands and scripts.
It is interactive and supports single command execution, pre-set prompts, and maintaining a history of prompts and responses.Features 🚀Generate Command Line Commands:Generate shell commands with a description in free language of what the command should do.Execute Generated Commands:Allows immediate execution of the generated command.Interactive Mode:Allows entering prompts and commands on the fly.History:Keeps a history of the prompts and responses for future reference.Command Editing:Edit the generated command, providing greater flexibility and control over the command execution.Rich Text Output:Enhanced console output experience that highlights code blocks in the responses.Installation Instructions 📥PrerequisitesPython 3.6+OpenAI API keyStepsClone this repository:git clone <repo-url>Navigate into the project directory:cd <project-directory>Create a virtual environment:python3 -m venv envActivate the virtual environment:source env/bin/activate(for Linux/Mac) or.\env\Scripts\activate(for Windows)Install required packages:pip install -r requirements.txtSet up the OpenAI key as an environment variable:export OPENAI_KEY=your_openai_keyCode Structure 📂config.py: Contains the configuration for the OpenAI API like the API key and headers.openai_api.py: Contains the logic for making requests to the OpenAI API.prompts.py: Contains the prompts used for generating shell commands.shell_utils.py: Contains utility functions for loading and saving history, printing history, and executing shell commands.main.py: The main entry point of the application. It uses click to parse command-line arguments and handles the flow of the application.Configuration 🔧The tool requires an OpenAI key to function, which should be set as an environment variableOPENAI_KEY. Please refer to the OpenAI API documentation to obtain your API key.Examples 📖With a prompt (-p / --prompt):python main.py --prompt "simple Python HTTP server with Flask."fromflaskimportFlask# Create the Flask applicationapp=Flask(__name__)# Define the route and handler for the root URL@app.route('/')defhello():return'Hello, World!'# Start the Flask applicationif__name__=='__main__':app.run()With a command (-c / --cmd):python main.py --cmd "find all files larger than 3 megabytes in the current directory and its subdirectories"find.-typef-size+3MInteractive Mode (-i / --interactive):➜python3main.py -iEnter a prompt:command: display the top 10 processes sorted by memory usage⠸ Processing...The command is:top -o mem -l 1 -n 10 -stats pid,command,mem -l 1 | awk '$3 > 1 {print $0}'

Do you want to execute this command? (y/n) or edit (e): y

Output:
10 PID    COMMAND          MEM
11 54499* pycharm          4004M
12 65519* ScreenX          2760M
13 75199* Sublime Text     1973M
14 86418* Finder           1815M
15 454*   WindowServer     1461M
16 3435*  Raycast          861M
17 33109* Brave Browser    842M
18 25102* Brave Browser    658M
19 77155* Brave Browser    389M
20 23415* Brave Browser    335MEnter a prompt:Security Considerations ⚠️The app has the potential to execute shell commands, which comes with inherent security risks.
Please review all generated commands carefully before choosing to execute them, and avoid running commands that you don't fully understand.Contributing 🤝If you'd like to contribute to the development of this tool, please feel free to fork the repository, make your changes, and create a pull request.Future Work 💡Future updates can potentially include additional interactive features, improved command generation, integration with other language models or APIs, and more.Disclaimer ⚠️This app is developed for demonstration purposes and is not officially associated with or endorsed by OpenAI.License 📜The project is released underMIT License.