Extract meaning from your verbose git commits into a succinct paragraph within your pull requests.

Simply add this as a step in your CI/CD process and your PRs will be annotated with a single paragraph describing the git commits involved.

Required An environment variable containing your OpenAI api key.

Required Your Github token with read/write permissions.

Required Your OpenAI organization id.

uses: actions/commit-meaning
with:
  openai-api-key: "$OPENAI_API_KEY"
  openai-org: "$OPENAI_ORG"
  github-token: "$GITHUB_TOKEN"

You can fully customize the behavior of this action.

• temperature: The OpenAI temperature parameter
• tokens: The OpenAI tokens paremter (number of tokens)
• frequency-penalty: The OpenAI frequency_penalty parameter
• presence-penalty: The OpenAI presence_penalty parameter
• prompt-instructions: Additional input instructions for the prompt

We employ the use of gitmoji at Tincre to annotate our commit messages with rich categorization.

This action by default uses the following prompt by default:

• 🐞 and 🐛 "refers to a bug fix"
• ♻️ "means to refactor code or content"
• ✨ "means something is new in the code"
• 🔧 "refers to code that is configuration or low-level in nature"
• 🔥 "means to remove code or remove content"
• 🚧 "references a commit considered to be work in-progress", and
• 📓 "references changes to documentation."

We ❤️ contributions! File an issue, PR, or suggestion to improve this action.

This action is liberally licensed under the MIT license.

And we at Tincre would love attribution, if you feel so inclined.