v0.3.0 - agent-callable interface

Machine-callable surface for agents, plus the Go CLI from v0.2.x.

Highlights

• --json on generate, edit, hair-color, batch, and version - exactly one JSON object on stdout; heartbeats stay on stderr
• Exit codes: 0 success, 1 usage, 2 auth, 3 permanent API, 4 retryable API, 5 local I/O
• gpt-image --help-agent embeds the agent guide (AGENTS.md)
• version reports the default model (gpt-image-2); version --json for a structured envelope
• Estimated USD cost, retries with backoff, --timeout / --quiet / --no-cost / --api-key-file (unchanged)

Install

curl -fsSL -o gpt-image \
  https://github.com/JacobStephens2/gpt-image/releases/latest/download/gpt-image-linux-amd64
chmod +x gpt-image
sudo mv gpt-image /usr/local/bin/gpt-image
export OPENAI_API_KEY="..."
gpt-image version --json

Or with Go 1.22+:

go install github.com/JacobStephens2/gpt-image/cmd/gpt-image@v0.3.0

Agent contract: AGENTS.md · design record: docs/specs/agent-interface.md

Assets

File	Platform
gpt-image-linux-amd64	Linux x86_64
gpt-image-linux-arm64	Linux arm64
gpt-image-darwin-amd64	macOS Intel
gpt-image-darwin-arm64	macOS Apple Silicon
gpt-image-windows-amd64.exe	Windows x86_64
SHA256SUMS	checksums

Site: https://stephens.page/gpt-image/