Skip to content

Command line

Generated from the commands themselves, so this page cannot describe a flag the tool does not have.

Draft quick wins from a finished report with a hosted chat model.

Sends the report to model. Everything else complydoc computes stays on this machine; --classifier jev is the only other command that leaves it, and only with the passages it judges. This one sends the report’s findings, signals, loaders, costs and limitations, including masked identifiers and document paths. The page pictures and the text read off each page are held back. It never runs as part of audit or check; run it on its own, against a report one of those already wrote.

Terminal window
complydoc assist
Option Default What it does
--report — A report JSON already written by an audit.
--model gpt-5.6-luna Chat model id, passed to langchain’s init_chat_model.
--quiet, -q off Suppress progress output.

Run every check: cost, readiness, identifiers and hidden content.

Terminal window
complydoc audit {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc Base filename for the reports.
--monthly-volume — Documents per month, to extrapolate cost.
--vision-resolution medium Headline vision resolution preset.
--reveal off Print sensitive values in full. Off by default, and the report says so.
--model, -m — Model id to price, repeatable. Defaults to every priced model. See: complydoc models.
--page-images, --no-page-images off Keep a picture of each page beside what was extracted from it, with the identifiers found on it blacked out. Off by default: a picture still shows whatever the scan did not find.
--extracted-text, --no-extracted-text on Include the text read off each page, with its identifiers masked, so it can be read beside the page it came from. On by default; –no-extracted-text leaves the report carrying no document content.
--ocr-compare off Also OCR pages that already have a text layer, so the text layer and what OCR reads can be compared. Implies –extracted-text.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--ocr-engine — Which local OCR engine to read scans with.
--compare-ocr-engine — Also read every rasterised page with this engine and keep what it read, repeatable. It never changes a finding.
--compare-extractor — Also read every page with this one and report where the two disagree, repeatable. It never changes a finding.
--save-text — Also write the text read off each document into this folder, one file per document, with identifiers masked unless –reveal is set. Reading a scanned folder is the slow part; this keeps the result so nothing has to OCR it again.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--detail summary How much the JSON report carries. summary, the default, keeps every finding and score and the folder’s cost on each model, and leaves out the price of every document on every model and, unless –page-images asked for pictures, the page geometry the viewer draws pages with. full writes every field; use it for anything that reprocesses reports.
--quiet, -q off Suppress progress output.
--classifier — Score passages for hidden instructions with a classifier as well as the patterns. ‘jev’ is TypeSafe’s hosted model and SENDS THE PASSAGES IT JUDGES to api.typesafe.ai; ‘module:function’ is code of your own. The report names where anything was sent. Nothing is registered by default.
--classifier-threshold — Score at or above which a passage is reported, 0 to 1. Defaults to the value in hidden.yaml, except for ‘jev’, which uses the 0.5 measured for it.
--verify — Read pages again with a vision model of your own, ‘vision:module:function’, and report where it disagrees with the text kept. Your code makes the call with your key, and SENDS EACH PAGE IMAGE to wherever it calls; the report names the hosts. Nothing is verified by default.
--verify-scope flagged Which pages –verify reads: ‘flagged’ (routing sent them to vision, they had no usable reading, or two readers disagreed) or ‘all’ (every page).
--ignore-file — Findings to set aside, each with a reason. Without it, .complydoc-ignore.yaml at the top of the folder is read when there is one.
--categories — Identifier categories to switch off, or to call more or less serious. Without it, .complydoc-categories.yaml at the top of the folder is read when there is one.
--concepts — Your own things to look for, each described in words. Without it, .complydoc-concepts.yaml at the top of the folder is read when there is one.
--judge-concepts — Also ask a judgement model, page by page, about your concepts marked judge: true. ‘jev’ sends page text to TypeSafe; the report says so.

Measure what identifier detection finds and what it wrongly flags.

Terminal window
complydoc benchmark
Option Default What it does
--config-dir — Override the config directory.
--json — Write the scores as JSON to this path.
--verbose off List every miss and every wrongly flagged value.

Check documents against a policy file, and exit non-zero when they fail it.

Each rule is one of the checks cd.expect offers, named in YAML. A shipped pack can be named in place of a file: finance, legal or hr. Every rule runs, so one run lists everything that failed rather than the first thing. Exits 1 when a rule of level error fails, 2 when the policy or the path cannot be read.

Terminal window
complydoc check {target}
Argument What it is
target A file or folder to audit. Omit it when passing –report.
Option Default What it does
--policy — A YAML file of rules, or a shipped pack: finance, legal, hr.
--report — Check a report JSON already written, instead of auditing.
--markdown — Write the result as Markdown, for a pull request.
--sarif — Write the result as SARIF, for code scanning.
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-check Base filename for the reports.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--quiet, -q off Suppress progress output.
--classifier — Score passages for hidden instructions with a classifier as well as the patterns. ‘jev’ is TypeSafe’s hosted model and SENDS THE PASSAGES IT JUDGES to api.typesafe.ai; ‘module:function’ is code of your own. The report names where anything was sent. Nothing is registered by default.
--classifier-threshold — Score at or above which a passage is reported, 0 to 1. Defaults to the value in hidden.yaml, except for ‘jev’, which uses the 0.5 measured for it.
--ignore-file — Findings to set aside, each with a reason. Without it, .complydoc-ignore.yaml at the top of the folder is read when there is one.
--categories — Identifier categories to switch off, or to call more or less serious. Without it, .complydoc-categories.yaml at the top of the folder is read when there is one.
--concepts — Your own things to look for, each described in words. Without it, .complydoc-concepts.yaml at the top of the folder is read when there is one.
--judge-concepts — Also ask a judgement model, page by page, about your concepts marked judge: true. ‘jev’ sends page text to TypeSafe; the report says so.

Split a folder’s text with one or more splitters and inspect the chunks.

Each page’s text is read as extract_text reads it and passed to the splitter as documents with source and page metadata. Every chunk is scanned for identifiers and hidden passages and flagged when it is tiny, oversized, cut mid-sentence or mid-table, ends on a heading or repeats another chunk. With –questions, each question reports whether the chunk holding its answer ranks within –top-k. The reports hold masked previews only.

Terminal window
complydoc chunks {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--splitter, -s — A text splitter as module:attribute, followed by key=value arguments, e.g. ‘langchain_text_splitters:RecursiveCharacterTextSplitter chunk_size=800’. A class is created with the arguments; a function is called with the documents. Repeat to compare several.
--preset — A set of splitters to compare: ‘common’ runs recursive splitting at three sizes, character and token splitting, and LlamaIndex’s sentence splitter.
--fact — Text a chunk should contain whole, repeatable.
--questions — A YAML list of questions, each with question, fact and optionally document. Chunks are ranked for each question with BM25 keyword search.
--top-k 5 How many top-ranked chunks count as retrieved.
--model, -m — Model whose tokenizer counts tokens.
--min-tokens 20 Flag chunks with fewer tokens as tiny.
--max-tokens — Flag chunks with more tokens as oversized.
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-chunks Base filename for the reports.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--quiet, -q off Suppress progress output.

Copy documents with their identifiers masked and their metadata removed.

Terminal window
complydoc clean {target}
Argument What it is
target A file or folder to copy safely.
Option Default What it does
--out — Where the copies are written.
--rasterise off PDFs only: render each page to an image, so no text layer survives.
--show off List what each copy changed, and where it was.
--recurse, --no-recurse on Descend into subfolders.
--config-dir — Override the config directory.
--quiet, -q off Suppress progress output.

Read every page with every reader and every OCR engine installed.

The same audit, with each library’s reading of each page kept beside the others. Only the first still reaches a finding; the rest are there to be compared against it, and the report marks the pages where they parted company.

Terminal window
complydoc compare {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-compare Base filename for the reports.
--page-images, --no-page-images off Keep a picture of each page beside what was extracted from it, with the identifiers found on it blacked out. Off by default: a picture still shows whatever the scan did not find.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--ocr-engine — Which local OCR engine to read scans with.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--save-text — Also write the text read off each document into this folder, one file per document, with identifiers masked unless –reveal is set. Reading a scanned folder is the slow part; this keeps the result so nothing has to OCR it again.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--quiet, -q off Suppress progress output.

Run several document loaders on the same documents and report their differences.

The file names each loader as module:attribute or a parser preset, the documents, and optionally the facts each loader’s text should contain. The first loader is the baseline. Loaders run with network access blocked unless the file sets allow_network: true. See the Comparing loaders guide for the format.

--verify vision:module:function reads the baseline’s pages again with a vision model of your own, and puts its reading beside every loader’s.

Terminal window
complydoc compare-loaders {spec}
Argument What it is
spec A YAML file naming the loaders, the documents and the expected facts.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-loaders Base filename for the reports.
--config-dir — Override the config directory.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--quiet, -q off Suppress progress output.
--verify — Read pages again with a vision model of your own, ‘vision:module:function’, and report where it disagrees with the text kept. Your code makes the call with your key, and SENDS EACH PAGE IMAGE to wherever it calls; the report names the hosts. Nothing is verified by default.
--verify-scope flagged Which pages –verify reads: ‘flagged’ (routing sent them to vision, they had no usable reading, or two readers disagreed) or ‘all’ (every page).

Read every page with every reader and every OCR engine installed.

The same audit, with each library’s reading of each page kept beside the others. Only the first still reaches a finding; the rest are there to be compared against it, and the report marks the pages where they parted company.

Terminal window
complydoc compare-readers {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-compare Base filename for the reports.
--page-images, --no-page-images off Keep a picture of each page beside what was extracted from it, with the identifiers found on it blacked out. Off by default: a picture still shows whatever the scan did not find.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--ocr-engine — Which local OCR engine to read scans with.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--save-text — Also write the text read off each document into this folder, one file per document, with identifiers masked unless –reveal is set. Reading a scanned folder is the slow part; this keeps the result so nothing has to OCR it again.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--quiet, -q off Suppress progress output.

Estimate LLM processing cost only.

Terminal window
complydoc cost {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-cost Base filename for the reports.
--monthly-volume — Documents per month, to extrapolate cost.
--vision-resolution medium Headline vision resolution preset.
--model, -m — Model id to price, repeatable. Defaults to every priced model. See: complydoc models.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--ocr-engine — Which local OCR engine to read scans with.
--compare-ocr-engine — Also read every rasterised page with this engine and keep what it read, repeatable. It never changes a finding.
--compare-extractor — Also read every page with this one and report where the two disagree, repeatable. It never changes a finding.
--save-text — Also write the text read off each document into this folder, one file per document, with identifiers masked unless –reveal is set. Reading a scanned folder is the slow part; this keeps the result so nothing has to OCR it again.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--detail summary How much the JSON report carries. summary, the default, keeps every finding and score and the folder’s cost on each model, and leaves out the price of every document on every model and, unless –page-images asked for pictures, the page geometry the viewer draws pages with. full writes every field; use it for anything that reprocesses reports.
--quiet, -q off Suppress progress output.

Audit the sample documents, so you can see a report without finding a folder.

The samples ship with the tool and are synthetic: every identifier in them was invented. Between them they carry a scan with no text layer, a two-column page the readers disagree about, a whitespace table, and identifiers of several kinds — the problems this exists to find.

Terminal window
complydoc demo
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--open, --no-open on Open the report in the viewer when it is written.

Compare two report JSON files and list what got worse and what got better.

Documents are matched by relative path. A regression is an identifier, metadata finding or hidden passage that appeared, a score or text similarity that fell, a fact a loader no longer finds, a new network attempt or failed file, or a new important limitation. Exits 1 when there is a regression, 2 when a file cannot be read.

Terminal window
complydoc diff {old} {new}
Argument What it is
old The earlier report JSON, such as a baseline.
new The later report JSON.
Option Default What it does
--tolerance 0.5 Ignore score changes smaller than this many points.
--fail-on-regression, --no-fail-on-regression on Exit with status 1 when anything got worse. On by default, for CI.
--out, -o — Also write the changes as JSON and HTML here.
--name complydoc-diff Base filename for the reports.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--quiet, -q off Suppress progress output.

Report what is installed, what is not, and what that costs you.

Terminal window
complydoc doctor
Option Default What it does
--config-dir — Override the config directory.

List the local OCR engines.

Terminal window
complydoc engines

List the libraries that can read a PDF’s text layer, and what each provides.

Terminal window
complydoc extractors

Find every document, pipeline step and host a value reached.

Reports hold a fingerprint of each identifier they found, never the value. The value you give is hashed the same way and the reports are searched for it, so it is not written anywhere, and the answer comes from reports that never held it.

Terminal window
complydoc find {value}
Argument What it is
value The value as it is written, such as an account number or a name, or a finding’s fingerprint. Left out, it is asked for without being shown, which also keeps it out of your shell history.
Option Default What it does
--in — Report files, or folders to search for them. Repeat for several. Defaults to .complydoc.
--json off Print the result as JSON.

Set a finding aside, with the reason it is not a problem.

Ignored findings stay in the report, marked as ignored with their reason, and leave every count and every policy rule, so complydoc check passes on them. The file holds fingerprints and reasons, never a value found.

Terminal window
complydoc ignore {finding}
Argument What it is
finding The finding’s fingerprint, from a report: id-… or ct-…
Option Default What it does
--reason, -r — Why it is not a problem. Required to add one.
--until — The date it stops applying, YYYY-MM-DD.
--path — Only in documents matching this glob. Repeatable.
--what — What the finding is, in words, for whoever reads the file.
--by — Who decided. Defaults to git’s user.name.
--report — A report JSON to describe the finding from.
--file .complydoc-ignore.yaml The ignore file. Keep it at the top of the audited folder.
--remove off Stop ignoring the finding.
--list off List what is ignored.

Let an AI assistant open documents through complydoc, over MCP on stdio.

Add complydoc mcp --folder <dir> to Claude Desktop or any MCP client.

The assistant gets list_documents, check_document and open_document, and what it reads has personal and financial details masked and hidden passages taken out. choose_folder lets the person add a folder from the conversation, through the system’s folder dialog.

With --runs .complydoc, an engineer can also ask about recorded runs: step times of a pipeline, loaders compared, evals, and where a value went.

Terminal window
complydoc mcp
Option Default What it does
--folder — A folder the assistant may open documents from; give it once per folder. More can be chosen from the conversation. Nothing outside them is read.
--fetch-name-model off Download the model that finds names of people and companies (about 700 MB) once, if it is missing. It needs the multilingual-names extra.
--runs — A folder of complydoc reports, such as .complydoc; give it once per folder. Adds the tools for engineers: list_runs, show_run, compare_runs and find_value.

List the models available to price against, and the date of their prices.

Every price comes from the vendored price table, refreshed each week. The default comparison is each provider’s current line-up; the rest of the table can be named with –model.

Terminal window
complydoc models {match}
Argument What it is
match Show only models whose id contains this.
Option Default What it does
--provider — Show only one provider’s models.
--all off Include every model in the vendored price table.
--new — Show the N most recently released models instead.
--config-dir — Override the config directory.

Print pricing.yaml entries generated from litellm’s price table.

complydoc will not invent a price, so the shipped config leaves non-Anthropic models as empty templates. This fills them in from a maintained source and stamps each with the date you ran the import.

litellm is not a runtime dependency and is never imported during an audit — only its data file is read, and only when you run this.

Terminal window
complydoc pricing-import
Option Default What it does
--from — Path to litellm’s model_prices_and_context_window JSON.
--model, -m — Model id to import, repeatable.
--provider — Import every vision model from one provider.
--limit 20 Cap how many are printed.

Measure extraction readiness signals only.

Terminal window
complydoc readiness {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-readiness Base filename for the reports.
--extracted-text, --no-extracted-text on Include the text read off each page, with its identifiers masked, so it can be read beside the page it came from. On by default; –no-extracted-text leaves the report carrying no document content.
--ocr-compare off Also OCR pages that already have a text layer, so the text layer and what OCR reads can be compared. Implies –extracted-text.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--ocr-engine — Which local OCR engine to read scans with.
--compare-ocr-engine — Also read every rasterised page with this engine and keep what it read, repeatable. It never changes a finding.
--compare-extractor — Also read every page with this one and report where the two disagree, repeatable. It never changes a finding.
--save-text — Also write the text read off each document into this folder, one file per document, with identifiers masked unless –reveal is set. Reading a scanned folder is the slow part; this keeps the result so nothing has to OCR it again.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--quiet, -q off Suppress progress output.

Plan how each page should be read: its text layer, local OCR, or a vision model.

Writes a manifest an ingestion job can read, with a route and a reason for every page, and prices that mix against sending everything one way. Pages go to a vision model when plain text would lose them: a table with merged or stacked headers, a page that is mostly picture, a text layer that is not text, or a page with no text layer at all. The thresholds are in readiness.yaml under routing.

Terminal window
complydoc routing {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-routing Base filename for the reports.
--model, -m — Model id to price, repeatable. Defaults to every priced model. See: complydoc models.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--quiet, -q off Suppress progress output.

Print the shape of the report JSON, for a caller that needs to parse it.

A summary by default: the keys, and what each holds. With –json-schema, the whole shape as JSON Schema, generated from the code that writes the report.

Terminal window
complydoc schema
Option Default What it does
--json-schema off Print the report’s full JSON Schema, for a validator or a code generator, in place of the summary.

Scan for personal and financial identifiers only.

Terminal window
complydoc sensitive {target}
Argument What it is
target A file or folder to audit.
Option Default What it does
--out, -o .complydoc Directory for the reports. For the commands that write a report, also a bucket folder: s3://bucket/folder.
--name complydoc-sensitive Base filename for the reports.
--reveal off Print sensitive values in full. Off by default, and the report says so.
--page-images, --no-page-images off Keep a picture of each page beside what was extracted from it, with the identifiers found on it blacked out. Off by default: a picture still shows whatever the scan did not find.
--extracted-text, --no-extracted-text on Include the text read off each page, with its identifiers masked, so it can be read beside the page it came from. On by default; –no-extracted-text leaves the report carrying no document content.
--password — Password to try on encrypted PDFs. Passed on the command line, so it will be in your shell history.
--jobs, -j — Documents to process at once. The default reads the size of the folder and decides; 1 forces one process. Changes how long the run takes and nothing about what it finds.
--sample — Audit at most this many documents, keeping each file type’s share of the folder. The report says it is a sample.
--timeout — Seconds to give each document. A document still being read when the time passes is stopped and listed as skipped. 0 means no limit. Reading happens in a worker process when this is set, even with –jobs 1.
--config-dir — Override the config directory.
--ocr, --no-ocr on Read scanned pages with local OCR. On by default, so a scanned page is still readable; –no-ocr is faster.
--recurse, --no-recurse on Descend into subfolders.
--extractor — Which library reads the text layer. Defaults to complydoc’s own reading: text through pdfium, boxes and tables through pdfplumber. pdfium alone is far quicker and reads no table structure. See: complydoc extractors.
--ocr-engine — Which local OCR engine to read scans with.
--compare-ocr-engine — Also read every rasterised page with this engine and keep what it read, repeatable. It never changes a finding.
--compare-extractor — Also read every page with this one and report where the two disagree, repeatable. It never changes a finding.
--save-text — Also write the text read off each document into this folder, one file per document, with identifiers masked unless –reveal is set. Reading a scanned folder is the slow part; this keeps the result so nothing has to OCR it again.
--print-json off Write the JSON report to stdout and nothing else, for piping into another tool or an agent. Progress goes to stderr.
--quiet, -q off Suppress progress output.
--classifier — Score passages for hidden instructions with a classifier as well as the patterns. ‘jev’ is TypeSafe’s hosted model and SENDS THE PASSAGES IT JUDGES to api.typesafe.ai; ‘module:function’ is code of your own. The report names where anything was sent. Nothing is registered by default.
--classifier-threshold — Score at or above which a passage is reported, 0 to 1. Defaults to the value in hidden.yaml, except for ‘jev’, which uses the 0.5 measured for it.

Print the agent skill, or install it so an agent picks complydoc up on its own.

Terminal window
complydoc skill
Option Default What it does
--install off Copy the skill into ~/.claude/skills/complydoc.
--to — Install somewhere other than ~/.claude/skills.

Open the report viewer on the reports in a folder, served from this machine.

Every audit report found is listed, grouped by the folder it audited, newest run first, and a report written while the viewer runs appears on reload. The server listens on 127.0.0.1 only and makes no outbound connection. Ctrl+C stops it.

A folder of documents with no report in it is audited first, as demo audits its samples, and the viewer opens on the report. The audit runs here, before the server starts.

With –host it serves a team: everyone who can reach the address reads the same reports. It has no sign-in, so put it on a network you trust or behind your own proxy.

Terminal window
complydoc ui {sources}
Argument What it is
sources Report files, or folders to search for them: on this machine, or in a bucket as s3://bucket/folder. Defaults to .complydoc, where an audit writes when no –out is given.
Option Default What it does
--port, -p 8500 Port to serve on; the next free one is used if taken.
--browser, --no-browser on Open the viewer in the browser.
--host 127.0.0.1 Address to listen on. The default is this machine only; 0.0.0.0 serves the reports to whoever can reach it, read-only and with no sign-in.
--read-only, --allow-edits off Whether the viewer may change the ignore, concepts and categories files. Read-only by default when –host serves it to others.
--allowed-host — A name the viewer is reached by, beside this machine’s own, such as the one a proxy serves it under. Repeat for several; * accepts every name.