Reference

Commands

Command reference

summarize is one binary with a handful of subcommands. The default subcommand is summarize itself — the one you use 99% of the time. The others wrap related tooling.

#Subcommands

  • summarize — main command. Takes a URL, file, or stdin and produces a summary or extracted content.
  • summarize slides — extract scene-change keyframes from a video URL into PNGs (and optional OCR text). Standalone version of the --slides flag.
  • summarize transcriber — set up local ONNX transcription (Parakeet, Canary). Prints the env vars you need.
  • summarize daemon — manage the local HTTP daemon that the Chrome Side Panel talks to. Subcommands: install, restart, status, uninstall, run.
  • summarize refresh-free — scan OpenRouter :free models, write working candidates to ~/.summarize/config.json.

#Output discipline

All subcommands keep the same output discipline — straight from gogcli's playbook so pipes and scripts stay parseable:

  • stdout: the result. Plain text, Markdown, JSON, or files (slides only).
  • stderr: progress, prompts, warnings, and errors.
  • --json produces a stable envelope on stdout.
  • --no-color strips ANSI; --plain skips ANSI/OSC rendering for Markdown.

#Global behavior

These flags apply to almost every subcommand:

FlagPurpose
--jsonStable JSON envelope on stdout. Disables streaming.
--no-colorStrip ANSI escapes from output.
--theme <name>Pick a CLI theme (SUMMARIZE_THEME env var also works).
--verbose / --debugDetailed progress on stderr.
--metrics off|on|detailedToken + timing metrics line. Default on.
--timeout <duration>Cap fetching + LLM calls. Accepts 30, 30s, 2m, 5000ms.
-V, --versionPrint version and exit.
--helpPrint rich help with examples.

#Exit codes

CodeMeaning
0Success.
1Generic failure (extraction, model, network, parsing).
2Usage error (bad flag, bad input).
124Timeout.

summarize daemon and summarize transcriber may surface platform-specific exit codes from the underlying service install (launchd, systemd, schtasks); check --verbose output for the raw error.