CLI reference¶

Generated directly from marq's actual click command tree (qmd_py.cli.main:cli) — this page can't drift out of sync with the code the way a hand-transcribed --help dump would.

marq¶

marq: centralized markdown/code search over Postgres/pgvector.

Usage:

marq [OPTIONS] COMMAND [ARGS]...

Options:

marq bench¶

Run search-quality benchmarks (precision/recall/MRR/F1) against a fixture file.

Usage:

marq bench [OPTIONS] FIXTURE_PATH

Options:

marq cleanup¶

Remove orphaned content/embeddings and inactive document records.

No VACUUM step (unlike the TS reference): Postgres's autovacuum handles space reclaim automatically, and a manual VACUUM on a shared server is more likely to cause lock contention than help.

Usage:

marq cleanup [OPTIONS]

Options:

marq collection¶

Manage indexed collections.

Usage:

marq collection [OPTIONS] COMMAND [ARGS]...

Options:

marq collection add¶

Add and index a collection.

Usage:

marq collection add [OPTIONS] PATH

Options:

marq collection exclude¶

Exclude a collection from default (unscoped) queries.

Usage:

marq collection exclude [OPTIONS] NAME

Options:

marq collection include¶

Include a collection in default (unscoped) queries.

Usage:

marq collection include [OPTIONS] NAME

Options:

marq collection list¶

List all collections with details.

Usage:

marq collection list [OPTIONS]

Options:

marq collection remove¶

Remove a collection by name.

Usage:

marq collection remove [OPTIONS] NAME

Options:

marq collection rename¶

Rename a collection.

Usage:

marq collection rename [OPTIONS] OLD_NAME NEW_NAME

Options:

marq collection show¶

Show collection details.

Usage:

marq collection show [OPTIONS] NAME

Options:

marq collection update-cmd¶

Set (or clear, if omitted) the pre-update command for a collection.

Usage:

marq collection update-cmd [OPTIONS] NAME [COMMAND_PARTS]...

Options:

marq context¶

Manage per-path and global search context.

Usage:

marq context [OPTIONS] COMMAND [ARGS]...

Options:

marq context add¶

Add context for a path (or "/" for global context).

Usage:

marq context add [OPTIONS] PATH TEXT

Options:

marq context check¶

Check for collections/paths missing context.

Usage:

marq context check [OPTIONS]

Options:

marq context list¶

List all contexts.

Usage:

marq context list [OPTIONS]

Options:

marq context rm¶

Remove context for a path (or "/" for global context).

Usage:

marq context rm [OPTIONS] PATH

Options:

marq doctor¶

Diagnose Postgres, pgvector, migrations, and LLM-router health.

Usage:

marq doctor [OPTIONS]

Options:

marq embed¶

Generate vector embeddings for pending documents.

Usage:

marq embed [OPTIONS]

Options:

marq get¶

Get a document by path or docid; optional line range (path:from:count).

Usage:

marq get [OPTIONS] FILEPATH

Options:

marq ls¶

List collections, or files in a collection[/path].

Usage:

marq ls [OPTIONS] [PATH_ARG]

Options:

marq mcp¶

Start the MCP server (stdio by default), or manage the HTTP daemon (see 'mcp stop').

Usage:

marq mcp [OPTIONS] [COMMAND] [ARGS]...

Options:

marq mcp stop¶

Stop the background MCP HTTP daemon.

Usage:

marq mcp stop [OPTIONS]

Options:

marq multi-get¶

Get multiple documents by glob pattern or comma-separated list.

Usage:

marq multi-get [OPTIONS] PATTERN

Options:

marq query¶

Hybrid search: query expansion + BM25/vector RRF fusion + LLM reranking (recommended). Accepts a multi-line query document of lex:/vec:/hyde: (+ optional intent:) lines to bypass automatic expansion.

Usage:

marq query [OPTIONS] QUERY

Options:

marq query¶

Hybrid search: query expansion + BM25/vector RRF fusion + LLM reranking (recommended). Accepts a multi-line query document of lex:/vec:/hyde: (+ optional intent:) lines to bypass automatic expansion.

Usage:

marq query [OPTIONS] QUERY

Options:

marq search¶

Full-text keyword search (BM25, no LLM).

Usage:

marq search [OPTIONS] QUERY

Options:

marq skill¶

Show or install the marq skill (bootstrap instructions for agents).

Usage:

marq skill [OPTIONS] {show|install}

Options:

marq skills¶

List and retrieve bundled runtime skills.

Usage:

marq skills [OPTIONS] [COMMAND] [ARGS]...

Options:

marq skills get¶

Print one or more bundled runtime skills.

Usage:

marq skills get [OPTIONS] [NAMES]...

Options:

marq skills list¶

List bundled runtime skills.

Usage:

marq skills list [OPTIONS]

Options:

marq skills path¶

Print a bundled skill's directory (or all bundled skill directories).

Usage:

marq skills path [OPTIONS] [NAME]

Options:

marq status¶

Show index status and collections.

Usage:

marq status [OPTIONS]

Options:

marq update¶

Re-index all collections; configured update commands run first.

Usage:

marq update [OPTIONS]

Options:

marq vsearch¶

Vector similarity search (no reranking).

Usage:

marq vsearch [OPTIONS] QUERY

Options: