Shell Whisperer is a command-line productivity tool for Python developers that generates CLI (Command Line Interface) commands based on natural language input. Powered by OpenAI's GPT-3.5-turbo language model, Shell Whisperer can understand a wide range of tasks described in plain English and provide the corresponding shell commands. Optionally, it can also provide explanations of how the generated commands work.
To install Shell Whisperer, you can use pip, the Python package manager. We recommend installing Shell Whisperer in a virtual environment to isolate it from your system Python environment.
Creating a Virtual Environment To create a virtual environment, follow these steps:
# Navigate to your desired directory
cd /path/to/directory
# Create a virtual environment named 'venv'
python3 -m venv venv
# Activate the virtual environment
source venv/bin/activate # On macOS and Linux
venv\Scripts\activate # On Windows
With the virtual environment activated, you can install Shell Whisperer from PyPI using the following command:
pip install shell-whisperer
This will download and install Shell Whisperer and its dependencies.
Once installed, you can use the whisperer command (or the entry point you defined) to interact with Shell Whisperer. Here's an example of how to use the tool:
whisperer configure
Output:
Enter your OpenAI key:
whisperer request "list all files in the current directory"
whisperer request "list all files in the current directory" --explain
I welcome contributions to Shell Whisperer! If you encounter any issues or have feature requests, please feel free to open an issue on the project's repository.
Shell Whisperer is released under the MIT License.