README.md in openai-please-0.1.0 vs README.md in openai-please-0.1.1

- old
+ new

@@ -1,39 +1,37 @@ # Please -Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/please`. To experiment with that code, run `bin/console` for an interactive prompt. +**⚠️ Requires an access token for OpenAI Codex, which is currently in private beta** -TODO: Delete this and the text above, and describe your gem +Convert natural language to bash commands using OpenAI Codex +![Demo video](https://user-images.githubusercontent.com/4272090/133416481-febce287-1c3b-4a10-ab3e-b7228d403d7a.gif) + ## Installation -Add this line to your application's Gemfile: + $ gem install openai-please -```ruby -gem 'please' +Ensure your [OpenAI API key](https://help.openai.com/en/articles/5480100-how-do-i-gain-access-to-openai-codex) is stored in an environment variable. + ``` +OPENAI_ACCESS_TOKEN=[YOUR ACCESS TOKEN HERE] +``` -And then execute: - - $ bundle install - -Or install it yourself as: - - $ gem install please - ## Usage -TODO: Write usage instructions here +```shell +user@host:~$ please find all files larger than 1 mb +$ find . -type f -size +1M +Run the command? (enter "h" for help) [y,n,e,h] +``` -## Development +You can [e]dit the command before running it by pressing the 'e' key. This uses the editor specified in the $EDITOR variable, defaulting to vi. -After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment. +## Privacy -To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org). +In addition to the instruction text, the result of each of the following commands is sent to OpenAI Codex to improve the relevance of completions. -## Contributing +- `pwd` +- `uname -a` +- `ls -a` -Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/please. - -## License - -The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT). +See [OpenAI's privacy policy](https://beta.openai.com/policies/privacy-policy) for more information.