v1.0.1 - reliable interactive image save

After a successful API call, inkvoke always saves the image: invalid/long output paths (often leftover paste) fall back to inkvoke-.png and the absolute path is printed. Also captures trailing partial paste lines into the prompt and strips shell wrappers.

v1.0.0 - inkvoke

inkvoke v1.0.0

inkvoke — single-binary, agent-friendly image generation and editing CLI. Powered by OpenAI gpt-image-2.

Rename of gpt-image (decision record).

Install (macOS Apple Silicon)

curl -fsSL -o inkvoke \
  https://github.com/JacobStephens2/inkvoke/releases/latest/download/inkvoke-darwin-arm64
chmod +x inkvoke
sudo mv inkvoke /usr/local/bin/inkvoke
inkvoke version

Transition

Same bytes also shipped as gpt-image-*. Running as gpt-image prints a stderr-only deprecation note.

go install github.com/JacobStephens2/inkvoke/cmd/inkvoke@v1.0.0

Agent contract: AGENTS.md

v0.3.3 - auto-capture pasted image prompts

What changed

Interactive Image prompt now captures whatever you type or paste as the text sent to the OpenAI Images API:

• Multi-line / multi-paragraph paste is auto-drained (no --- required)
• Blank lines inside the paste are kept
• Single line + Enter still works
• Optional: still end with --- or Ctrl-D

Install (macOS Apple Silicon)

curl -fsSL -o gpt-image \
  https://github.com/JacobStephens2/gpt-image/releases/download/v0.3.3/gpt-image-darwin-arm64
chmod +x gpt-image
sudo mv gpt-image /usr/local/bin/gpt-image
hash -r
gpt-image version   # must show 0.3.3

Interactive

$ gpt-image
Command … [generate]:     # Enter
Image prompt
>                         # paste full prompt, wait a beat
Output path …

v0.3.2 - multi-line interactive paste fix

Fix

Interactive mode no longer breaks when you paste a multi-paragraph image prompt.

• Multi-line prompts: paste freely, end with a line containing only --- (or Ctrl-D)
• Shared stdin reader: later wizard questions no longer steal paste lines
• Command recovery: if you paste the prompt on the Command step, it is treated as generate

Install (macOS Apple Silicon)

curl -fsSL -o gpt-image \
  https://github.com/JacobStephens2/gpt-image/releases/latest/download/gpt-image-darwin-arm64
chmod +x gpt-image
sudo mv gpt-image /usr/local/bin/gpt-image
gpt-image version   # expect 0.3.2

Interactive generate

$ gpt-image
Command … [generate]:     # press Enter
Image prompt
  (paste multi-line text OK; finish with --- or Ctrl-D)
> …paste your prompt…
> ---
Output path [generated.png]:
…

v0.3.1 - interactive install UX and --uninstall

Human-friendly CLI UX on top of the v0.3.0 agent surface.

Highlights

• gpt-image --uninstall / gpt-image uninstall — remove the running binary (use sudo if root-owned)
• Interactive mode — bare gpt-image (or a command missing required args) on a TTY asks one question at a time
• API key prompt — if OPENAI_API_KEY / --api-key-file are unset on a TTY, prompt once (hidden input, not saved)
• README install — per-platform binary instructions and amd64 vs arm64 guidance
• Agents / non-TTY behavior unchanged (--json, exit codes 0–5)

Install

macOS Apple Silicon:

curl -fsSL -o gpt-image \
  https://github.com/JacobStephens2/gpt-image/releases/latest/download/gpt-image-darwin-arm64
chmod +x gpt-image
sudo mv gpt-image /usr/local/bin/gpt-image
gpt-image version

Linux amd64:

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
gpt-image version

Or with Go 1.22+:

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

Uninstall: sudo gpt-image --uninstall

Agent contract: AGENTS.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/

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/

v0.2.1 - Go CLI

First release of gpt-image as a Go binary (no Python runtime).

Highlights

• Single static binary for generate, edit, batch, and hair-color
• Default model: gpt-image-2
• Estimated USD cost from Images API usage tokens
• Retries with backoff; stderr progress heartbeats on long runs
• --timeout (default 300s), --quiet, --no-cost, --api-key-file

Install

Download the binary for your platform below, then:

chmod +x gpt-image-linux-amd64   # or your platform asset
sudo mv gpt-image-linux-amd64 /usr/local/bin/gpt-image
export OPENAI_API_KEY="..."
gpt-image version

Or with Go 1.22+:

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

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/