CLI reference

Stub

Final content will be one section per subcommand: acid query, acid validate, acid download, acid inspect, acid hats build-margin. Each flag will get a sentence and a worked example.

Subcommands planned:

  • acid query — execute a SQL query (--db, --out, --workers, --engine, -f, --duckdb-threads, --reduced-out, stdin support).
  • acid validate — parse + analyze without executing.
  • acid download — fetch a HATS catalog (--cone, --columns, --workers, --estimate, --skip-margin, --timeout).
  • acid inspect — show summary, schema, or properties of a local or remote catalog.
  • acid hats build-margin — build a margin cache locally (--margin-arcsec, --workers, --output, --overwrite, --mem-limit).

Until this page lands, every subcommand's --help text is authoritative:

acid --help
acid query --help
acid download --help
acid inspect --help
acid hats build-margin --help