CLI Overview

Install

npm install -g @goodtake/cli

Requires Node.js ≥ 18.

gt auth login

This opens your browser and runs the OAuth device flow. After login, your API key is stored in ~/.goodtake/config.json (mode 0600).

gt auth status    # check current key, org, and credit balance

gt generate image -m gpt-image-2 -p "a red fox sitting in snow, photorealistic"

The CLI submits the job, polls for the result, and downloads the image to ./goodtake-output/<id>.png.

gt generate image \
  -m seedream-4-5-251128 \
  -p "neon city street at night" \
  -a 16:9 \
  -o city.png

Flag	Description
`-m`, `--model`	Model identifier or fuzzy name (e.g. `flux`, `seedream`)
`-p`, `--prompt`	Text prompt
`-a`, `--aspect-ratio`	e.g. `16:9`, `1:1`, `9:16`
`-r`, `--resolution`	e.g. `2k`, `4k`
`-o`	Output file path
`--reference <url>`	Reference image URL (repeatable)
`--no-download`	Print URL only, skip download

See the full Commands reference for all flags.

Model names are fuzzy-matched — --model flux resolves to the best available flux model. Run gt models list to see exact identifiers.