zit
Tiny CLI · Big pixels

Images from your terminal.

Generate polished illustrations, banners, mockups, and visual drafts with one small command and WaveSpeed Z-Image-Turbo.

Install in seconds ↓ View source ↗

MIT licensed · Node.js 18+ · no build step

The zit mascot drawing beside a terminal window
1536 PX
MAX SIDE
$ zit "friendly robot mascot" --ratio wide --output ./images

✓ generated 1536×864
✓ saved ./images/zit-robot.jpeg
Built to stay small

One model.
Useful defaults.

zit skips the sprawling dashboard. It focuses on a fast, affordable model and the controls you actually reach for when making visuals for a project.

01 / FAST

Prompt and go

Pass your prompt as plain text. zit handles submission, polling, and the final output URL.

02 / FLEXIBLE

Right size, every time

Use familiar aliases like wide, portrait, poster, or phone—or provide exact dimensions.

03 / SCRIPTABLE

Made for workflows

Download locally, set a seed, request JSON, or feed in a reference image from disk.

Simple by design

From idea to file in three steps.

There is no project setup, config file, or build pipeline. Install it once, set your API key, and create.

1

Install the CLI

npm install -g @crapthings/zit-cli

2

Add your WaveSpeed key

export WAVESPEED_API_KEY="your-api-key"

3

Describe the image

zit "editorial product photo" --ratio 4:5

Shape your output

Ratios that read like words.

Quick aliases map to sensible dimensions with the longest side capped at 1536 pixels.

square · 1:1wide · 16:9portrait · 3:4poster · 2:3photo · 3:2phone · 9:16ultrawide · 21:9
Ready when your idea is

Make the image your project is missing.

npm install -g @crapthings/zit-cli