Skip to main content
gumloop chat completions create is the terminal counterpart of the Python SDK call client.chat.completions.create(...). Every flag maps 1:1 to the matching SDK kwarg.

​
Create a completion

gumloop chat completions create "Capital of Canada?" -m claude-sonnet-4-5
By default, output streams to your terminal when stdout is a TTY and is buffered into a single response when it isn’t (e.g. piped to a file or another command). Pass --stream or --no-stream to be explicit.
FlagDescription
-m, --modelRequired. Model slug (for example claude-sonnet-4-5, gpt-4o-mini, gemini-2.5-pro).
-s, --systemSystem message prepended to the conversation. Repeatable.
--message-stdin -Read the user message from stdin instead of the positional argument.
--max-completion-tokensCap on completion tokens.
--temperatureSampling temperature.
--modalityOutput modality. Repeatable — e.g. --modality image --modality text for image-generation models.
--schema-filePath to a JSON Schema file. Sent as response_format={"type": "json_schema", ...} for structured output.
--schema-nameName to attach to the schema (defaults to schema).
--stream / --no-streamForce or suppress streaming. When omitted, streams only if stdout is a TTY. --json implies --no-stream unless --stream is also passed.
--jsonPrint the response as JSON. With --stream, emits newline-delimited JSON (one chunk per line).

​
Pipe from stdin

cat draft.md | gumloop chat completions create -m claude-sonnet-4-5 \
  --message-stdin - \
  --system "Summarize the input in three bullets."

​
Structured output

gumloop chat completions create "Return JSON with the capital of Canada." \
  -m claude-sonnet-4-5 \
  --schema-file ./capital.schema.json \
  --schema-name capital \
  --json
capital.schema.json: 
{
  "type": "object",
  "properties": { "capital": { "type": "string" } },
  "required": ["capital"],
  "additionalProperties": false
}

​
Image generation

gumloop chat completions create "A red maple leaf on white" \
  -m gpt-image-1.5 \
  --modality image --modality text \
  --json
The response carries one or more image attachments on choices[0].message.images. Each entry is a data URL the caller can decode or render directly.

​
Streaming with machine output

--stream --json emits ndjson — one full chat.completion.chunk per line — so consumers can stitch deltas without re-parsing the full SSE wire format. 
gumloop chat completions create "stream me" -m claude-sonnet-4-5 --stream --json
The CLI streams to TTYs by default. When redirecting stdout (> out.txt, | jq, CI pipes) it switches to unary so output is byte-stable.