brew install openai/tools/openai

go install 'github.com/openai/openai-cli/cmd/openai@latest'

export PATH="$PATH:$(go env GOPATH)/bin"

git clone https://github.com/openai/openai-cli.git
cd openai-cli
./scripts/run args...

export OPENAI_API_KEY="sk-..."
export OPENAI_ADMIN_KEY="sk-admin-..."  # For admin endpoints
export OPENAI_ORG_ID="org-..."          # Optional
export OPENAI_PROJECT_ID="proj_..."     # Optional

openai --api-key sk-... responses create --input "Hello"

openai [resource] <command> [flags...]

openai responses create \
  --input "Explain quantum computing in simple terms" \
  --model gpt-4

openai responses create \
  --input "Write a poem about coding" \
  --model gpt-4 \
  --stream

openai responses create \
  --input "What is recursion?" \
  --model gpt-4 \
  --system "You are a computer science teacher" \
  --temperature 0.7

openai files create \
  --file @training_data.jsonl \
  --purpose fine-tune

openai files list

openai files retrieve file-abc123

openai files delete file-abc123

openai embeddings create \
  --input "The quick brown fox" \
  --model text-embedding-3-small

openai embeddings create \
  --input "First text" \
  --input "Second text" \
  --model text-embedding-3-large

openai fine-tuning jobs create \
  --training-file file-abc123 \
  --model gpt-3.5-turbo

openai fine-tuning jobs list

openai fine-tuning jobs retrieve ftjob-abc123

openai fine-tuning jobs cancel ftjob-abc123

openai admin:organization:usage completions \
  --start-time 1735689600 \
  --end-time 1735776000 \
  --bucket-width 1d

openai responses create --arg @input.txt

openai <command> --arg '{image: "@image.jpg"}'

openai <command> <<YAML
arg:
  image: "@abe.jpg"
YAML

openai <command> --arg @file://myfile.txt

openai <command> --arg @data://image.png

openai <command> --arg @file:///tmp/file.txt

openai <command> --username '\@username'

# Pretty-printed (default for TTY)
openai responses create --input "Hello" --format pretty

# Raw JSON
openai responses create --input "Hello" --format json

# JSONL (one JSON object per line)
openai responses create --input "Hello" --format jsonl

# YAML
openai responses create --input "Hello" --format yaml

# Raw response body
openai responses create --input "Hello" --format raw

# Get just the message content
openai responses create \
  --input "Hello" \
  --transform "choices.0.message.content"

# Get multiple fields
openai responses create \
  --input "Hello" \
  --transform "{id: id, content: choices.0.message.content}"

openai responses create \
  --input "Hello" \
  --format-error json \
  --transform-error "error.message"

--api-key           # API key (or use OPENAI_API_KEY)
--admin-api-key     # Admin key (or use OPENAI_ADMIN_KEY)
--organization      # Org ID (or use OPENAI_ORG_ID)
--project           # Project ID (or use OPENAI_PROJECT_ID)
--base-url          # Custom API endpoint
--debug             # Enable debug logging with HTTP details
--version, -v       # Show CLI version
--help              # Show help for command
--format            # Output format (auto, explore, json, jsonl, pretty, raw, yaml)
--format-error      # Error output format
--transform         # GJSON transform for data output
--transform-error   # GJSON transform for error output

while true; do
  read -p "You: " input
  openai responses create \
    --input "$input" \
    --model gpt-4 \
    --format pretty
done

while IFS= read -r line; do
  openai responses create \
    --input "$line" \
    --model gpt-3.5-turbo \
    --format json >> results.jsonl
done < inputs.txt

openai responses create \
  --input "Translate to French" \
  --model gpt-4 \
  --max-tokens 100 \
  --temperature 0.3

echo "Summarize this text" | openai responses create \
  --input "$(cat)" \
  --model gpt-4

cat document.txt | openai responses create \
  --input "Summarize: $(cat -)" \
  --model gpt-4

openai responses create \
  --input '{text: "What is in this image?", image: "@photo.jpg"}' \
  --model gpt-4-vision-preview

openai --base-url https://custom.openai.azure.com/v1 \
  responses create \
  --input "Hello" \
  --model gpt-4

openai --debug responses create --input "Test"

echo $PATH | grep "$(go env GOPATH)/bin"
# If not found:
export PATH="$PATH:$(go env GOPATH)/bin"

echo $OPENAI_API_KEY
# Should output: sk-...

openai responses create --input "test" --model gpt-3.5-turbo

# Absolute path
openai files create --file @/full/path/to/file.jsonl --purpose fine-tune

# Verify file exists
ls -la @file.jsonl

for i in {1..10}; do
  openai responses create --input "Request $i"
  sleep 1
done

openai models list

openai responses create --input "Hello" --format json

openai responses create --input "Hello" --format pretty | less

# Link to specific version
./scripts/link github.com/openai/openai-go@v1.2.3

# Link to local SDK copy
./scripts/link ../openai-go

# Default (../openai-go)
./scripts/link

openai --version
# or
openai -v

openai --help
openai responses --help
openai responses create --help