@goodtake/cli

GoodTake CLI (gt / goodtake) — generate AI images from your terminal.

Install

npm install -g @goodtake/cli

Requires Node.js >= 18.

Quick start

gt auth login                                  # authenticate via browser (device flow)
gt models list                                 # see available image models
gt generate image -m seedream -p "a sunset"    # submit → poll → download

Commands

Auth

gt auth login     # log in via your browser (RFC 8628 device flow)
gt auth status    # masked key + live org / credit balance
gt auth logout    # revoke the API key and clear local credentials

Generate

gt generate image -m <model> -p "<prompt>" \
  [-a 16:9] [-r 2k] [-o path.png] \
  [--reference <hosted-url>...] [--no-download]

-m accepts an exact model identifier or a fuzzy name match. --reference takes hosted image URLs (local file upload is not supported). Results download to ./goodtake-output/<generation-id>.<ext> by default; --no-download prints the output URL only. If a generation takes longer than 5 minutes the CLI stops waiting — check it later with gt generations get <id>.

Generations

gt generations list [--limit 20] [--offset 0]   # newest first
gt generations get <id>                         # details + output URL
gt generations download <id> [-o path]          # save the output to disk

Models & account

gt models list [--type image]    # identifier, name, provider, cost
gt account balance               # live credit balance
gt account topup --credits <n>   # opens Stripe checkout in your browser

Update

gt update            # update to the latest published version (npm install -g)
gt update --check    # report whether a newer version exists, without installing

gt update checks the npm registry and, if a newer release exists, runs npm install -g @goodtake/cli@latest. If you installed with a different package manager, update with that instead (e.g. pnpm add -g @goodtake/cli@latest).

Configuration

Credentials are stored in ~/.goodtake/config.json (file mode 0600).

Exit codes

0 success · 1 runtime error · 2 usage error.

Development

npm install
npm run build       # compile to dist/
npm run dev -- --help
npm run lint