Are you tired of Googling basic terminal commands every time you forget the syntax? Look no further! terminal-copilot is here to help.
With terminal-copilot, you can quickly and easily access commonly used terminal commands right from the command line. Simply type copilot followed by your desired command in natural language and let terminal-copilot do the rest.
For example, if you want to find a file ending in .txt, simply type:
copilot find a file ending in .txt
terminal-copilot will then display the correct syntax for the command you need:
find . -name "*.txt"
With options to execute, copy, or explain the proposed terminal command.
You can also use the copilot to ask a general question to gpt4 from your command line using the -q option
copilot -q "What is the best drink for late night coding?"
To use terminal-copilot, you must first install it on your system. The easiest way to do this is using pip:
pip install terminal-copilot
Once terminal-copilot is installed, you can access it from the command line by typing copilot followed by your question.
terminal-copilot is designed to be simple and intuitive to use. Simply type copilot followed by your question and terminal-copilot will display the correct syntax for the command you need.
Here are some examples of how you can use terminal-copilot:
copilot list the compute instances in gcloudcopilot find all mp3 files in my home directorycopilot install the openai package for pythoncopilot clean up my docker imagescopilot list my running k8s pods with tag 'awesome'
or you can ask a general question to gpt4 from your command line using the -q option
copilot -q Why is 42 the meaning of life
(note that question marks are not supported atm..)
Terminal-copilot can be called with optional command line arguments:
-a,--alias: Enables the inclusion of aliases in the prompt sent to the OpenAI API. May potentially send sensitive information to OpenAI.-v,--verbose: Increases output verbosity of the tool.-g,--git: This flag enables the inclusion of Git context in the prompt sent to the OpenAI API. This can be useful for users working with Git repositories and may include the current branch name, repository status, recent commit messages, and file history.-hist,--history: Enables the inclusion of terminal history in the prompt sent to the OpenAI API. May potentially send sensitive information to OpenAI and increase the number of tokens used.-j,--json: Output data as JSON instead of using an interactive prompt.-c,--count: The number of commands to output when JSON output is specified.-m,--model: The model to use. Defaults to gpt-3.5-turbo.-ns,--no-stream: Disable streaming the command into the terminal (by default, streaming is enabled).
Python 3.7+ Mac Os, Windows, or Linux
Please note that terminal-copilot has the ability to send sensitive information to OpenAI as part of the prompt used to generate terminal commands. This includes the --alias,--history, --git command line arguments, which may include sensitive information such as aliases and terminal history. If you are concerned about the potential for sensitive information to be sent to OpenAI, we recommend not using these flags. We recommend that users exercise caution when using these optional features and consider the potential risks before enabling them.
We welcome contributions to terminal-copilot! If you have an idea for a new feature or have found a bug, please open an issue. If you would like to contribute code, please open a pull request!
Thank you for considering contributing to terminal-copilot! Together, we can make it an even better tool for accessing terminal commands.
- Clone the repo
python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txtpython setup.py install
First make sure you have pip install wheel and pip install twine installed.
Then run the following commands:
0. Modify version in setup.py
rm -rf distpython setup.py sdist bdist_wheeltwine upload dist/*