shell-whiz 0.2.6

Shell Whiz: AI assistant right in your terminal

Shell Whiz will help you generate shell commands from your natural language queries. It is powered by OpenAI's gpt-3.5-turbo and is free to use.

All features

• Pay as you go: you only pay for what you use; no subscription is required. Just receive an API key from https://platform.openai.com/account/api-keys.
• Easy to install: run pip install shell-whiz and you're good to go.
• Easy to use: Shell Whiz is a command-line tool.

Supported platforms

Shell Whiz is designed to work on various platforms and shells, but it is best suited for Bash on Linux. However, it may sometimes suggest commands that are not compatible with your specific platform or terminal.

Installation and setup

To install Shell Whiz, run the following command:

$ pip install shell-whiz

This adds the command sw to your PATH.

To use Shell Whiz, you need an API key from OpenAI. You can get this key by visiting https://platform.openai.com/account/api-keys.

Then, run sw config to set up your API key.

Free API plan for new users

New users receive $5 for free to try and test the API during the first 3 months. However, it is recommended to upgrade to a paid plan in order to have a more comfortable experience using Shell Whiz. This is because the free plan has restrictions on the number of requests allowed per minute.

Upgrading

To upgrade Shell Whiz, run the following command:

$ pip install --upgrade shell-whiz

Usage

You can run Shell Whiz directly using sw ask, but I recommend creating an alias for it. For example, you can add the following line to your .bashrc file:

alias ??='sw ask'

To track API usage and costs, you can check the OpenAI API Usage page.

Tips

• If you want to pass an argument that starts with a hyphen, you can use -- to separate the command from the arguments. For example, sw ask -- emulate ARM kernel on versatilepb architecture -cpu cortex-a8.

More examples

License

Shell Whiz is licensed under the GNU General Public License v3.0. See LICENSE for more information.