aictl

Handy CLI accessing generative AI.

aictl

Install CLI

homebrew

brew install go-zen-chu/tools/aictl

binary

You can download from GitHub release.

Usage

If you have any trouble, use -v for verbosing logs.

Authentication

Currently aictl supports only environment variable.

export AICTL_OPENAI_API_KEY="your openai api key here"

In terminal

A simple usage

$ aictl query "How is the weather today?"
I'm sorry, but I cannot provide real-time weather information. You can check your local weather service or a weather app for the most accurate updates.

# you can ask in any language
$ aictl query "今日の天気はどうですか？"
I'm sorry, but I cannot provide real-time weather information. You can check your local weather service or a weather app for the most accurate updates.

Deliver a command result to stdin with -i option

$ echo "How is the weather today?" | aictl query -i
I'm sorry, but I cannot provide real-time weather information. You can check your local weather service or a weather app for the most accurate updates.

# Since, we got response as stdout, aictl's error as stderr you can pipe command results
$ aictl query "Hello" | aictl query -i | aictl query -i
Hello! How can I assist you today?

# To see how AI respond in each command, tee to stderr with pipe
$ echo $(./aictl query "Hello") | tee /dev/stderr | ./aictl query -i
Hello! How can I assist you today?
Hello! I'm here to assist you. How can I help you today?

Specify a query result format in text or json

$ echo "How is the weather today?" | aictl query -o json -i 
{
  "error": "Weather information is not available."
}

Specify which language you want to have a response

$ aictl query -ljapanese "Hello"
こんにちは！いかがお過ごしですか？何かお手伝いできることはありますか？

# You can specify in any language too if double quoted
$ aictl query -l"中文" "Hello"
你好！请问有什么我可以帮助你的？

Give text files and ask about the file

[!NOTE] If you give large files, you may get an error from API because of the number of tokens limit

$ aictl query "Why I got error in this Golang file?" -t ./testdata/go_error_sample1.go,./testdata/go_error_sample2.go
In your first Golang file, the error arises because the `fmt.Printf` function is called without providing the necessary arguments...

# By giving a files list of `git diff`, you can do a code review for changed files
$ aictl query -t "$(git diff --name-only HEAD origin/main | tr '\n' ',' | sed 's/,$/\n/')" "Could you give me a code review for each files with filename?"
Here's a code review for each file you've provided. The review will focus on structure, style, best practices, potential improvements, and any other relevant aspects.
---
### File: `README.md`
#### Review
1. **Structure**: The README has a clear structure that helps users understand what the project is about, how to authenticate, usage in the terminal, and usage in CI.

# If you want to review only diffs of the files, give a diff text
$ aictl query "Could you give me a code review for the diff below? \
These diffs are the result of \`git diff --no-ext-diff\` command. \
$(git diff --no-ext-diff)"

GitHub Actions

Parameters

name	value type	required	default	description
query	string	*	-	Query that you want to ask to generative AI
output	string	-	`text`	Response format. You can specify `text` or `json`. In `text` format, you can ask your response format in query to get other format like yaml but the actual response may differ according to AI response.
language	string	-	`English`	Which language you want to get response.
text-files	string	-	-	An array of text file paths added to query seperated with comma (e.g. file1.go,file2.txt)

Examples

Simple Query

Make sure to create API KEY in OpenAI and set secrets.AICTL_OPENAI_API_KEY in your github repository before running actions below.

jobs:
  check-aictl:
    runs-on: ubuntu-latest
    steps:
    # Example 1, a simple query
    - uses: go-zen-chu/aictl-query@main
      with:
        query: "Hello! GitHub Action"
      env:
        AICTL_OPENAI_API_KEY: ${{ secrets.AICTL_OPENAI_API_KEY }}
    # Example 2, a query with multiline
     - uses: go-zen-chu/aictl@main
      with:
        query: |
          Let me ask a question.
          Why I got error in this Golang file?
      env:
        AICTL_OPENAI_API_KEY: ${{ secrets.AICTL_OPENAI_API_KEY }}

With query options

jobs:
  check-aictl:
    runs-on: ubuntu-latest
    steps:
    # Example 3, specifing an output format and response language
    - uses: go-zen-chu/aictl-query@main
      with:
        query: "How are you doing?"
        language: "Japanese"
        output: "json"
      env:
        AICTL_OPENAI_API_KEY: ${{ secrets.AICTL_OPENAI_API_KEY }}

Review PR

name: check-pr
on:
  pull_request_target:
    types: [opened, synchronize]
jobs:
  check-aictl:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
    - name: Git checkout
      uses: actions/checkout@v4
    - name: Fetch base branch
      run: git fetch origin ${{ github.event.pull_request.base.ref }}
    - name: Get the diff between PR and target
      id: git-diff
      run: |
        diff_files=$(git diff --name-only HEAD origin/${{ github.event.pull_request.base.ref }} | tr "\n" ",")
        echo "diff_files: ${diff_files}"
        echo "diff-files=${diff_files}" >> "$GITHUB_OUTPUT"
    - uses: go-zen-chu/aictl-query@main
      with:
        query: "Could you give me a code review for each files with filename?"
        text-files: ${{ steps.git-diff.outputs.diff-files }}
      env:
        AICTL_OPENAI_API_KEY: ${{ secrets.AICTL_OPENAI_API_KEY }}

In the other CI

You can use aictl in any CI using docker image.

Development

We use magefile to make development easier.

# install required tools
mage installDevTools

# after main branch updated push new version tag
mage gitPushTag

go-zen-chu / aictl

readme