Install the package to expose dc. For PDF input, install the conversion
extra. The command uses a local store at ~/.local/share/docling-context by
default; pass --store PATH to choose another directory. --tenant and
--user select the principal; their defaults are default and local.
Use uv run dc or activate the project environment; a system calculator also
uses the name dc on some machines.
uv run --extra conversion dc --store ./context-data add-resource ./paper.pdf \
--collection papers --no-ocr --tables --no-charts
uv run dc --store ./context-data task status JOB_ID
uv run dc --store ./context-data jobs status JOB_ID --json
uv run dc --store ./context-data worker --once
uv run dc --store ./context-data status
uv run dc --store ./context-data index status
uv run dc --store ./context-data index lex status
uv run dc --store ./context-data index lex rebuild
uv run --extra vectors dc --store ./context-data index vector status
uv run --extra vectors dc --store ./context-data index vector rebuild
uv run --extra vectors dc --store ./context-data search "invoice" --mode hybrid
uv run dc --store ./context-data ls docling://resources/
uv run dc --store ./context-data tree docling://resources/papers -L 2
uv run dc --store ./context-data outline docling://resources/papers/paper
uv run dc --store ./context-data show docling://resources/papers/paper \
'/doclang[1]/text[1]' --format xml --json
uv run dc --store ./context-data find "invoice" --uri docling://resources/papers
uv run dc --store ./context-data grep "total" --uri docling://resources/papers
uv run dc --store ./context-data search "invoice" --uri docling://resources/papers
uv run dc --store ./context-data session start --id chat-1
uv run dc --store ./context-data session list --status open
uv run dc --store ./context-data memory list --status proposed
uv run docling-context integrate codex --scope project --store ./context-data
uv run docling-context doctor codex --scope project --store ./context-dataadd-resource accepts one document or a folder of documents. With the
conversion extra installed, it accepts Docling's supported formats, including
PDF, DOCX, PPTX, XLSX, images, HTML, and plain text. Native DCLG and DCLX files
also work without that extra. Folder imports scan the top level by default.
Add -r or --recursive to include subfolders; those paths are retained in
the URI. Use repeatable --from FORMAT options to select Docling format names,
such as --from pdf --from docx --from image (default: all). Filtering uses
filename extensions; Docling then detects the actual input format. Files with
the same stem and different extensions receive distinct URIs. A single file
can use --uri; otherwise --collection defaults to documents. Use --config
for a JSON conversion config, with command flags overriding it.
Use --force to create a new revision for unchanged input.
Table reconstruction always uses accurate mode; there is no CLI mode switch.
Page and picture images are on by default, and there is no default page limit.
--no-page-images, --no-picture-images, and --max-pages N override these
defaults. OCR uses RapidOCR with English PP-OCRv6 tiny models when enabled.
Ingestion is synchronous. Each new resource revision queues a collection-summary
job; add-resource prints the revision and its task_id. task status reports
that job. Run worker --once for one due job, or worker continuously. A
collection summary may remain stale until its latest job completes.
outline URI reads the TOC sidecar and show URI XPATH reads one cited node.
Use --revision ID for an immutable revision, --format xml for DocLang XML,
and --max-chars N to bound output. Both commands support --json; JSON
includes the URI, document ID, revision ID, XPath, and truncation marker.
docling-context exposes the existing dc commands and adds mcp,
integrate, doctor, remove, and ingest-worker. See the
agent harness guide for scopes, remote tokens, and verification.
Every status command prints a table by default. Pass --json for structured
output, for example dc status --json, dc task status JOB_ID --json, or
dc index vector status --json.
The main status also shows session, memory, and memory compilation job counts
for the selected user. List commands use tables by default and JSON arrays with
--json. The session and memory lists support --limit and --offset pages;
the default page size is 100 and the maximum is 1,000.
Start a session before recording events. start --id is idempotent for an open
session; omit --id to generate one. Session commands use the selected tenant
and user. append needs a stable --key, so a retried harness hook cannot
duplicate an event. Use --stdin for text that should stay out of process
arguments. An optional binary --attachment is stored as a typed DCLX part.
uv run dc session start --id chat-1 --json
printf 'I prefer concise replies' | uv run dc session append chat-1 \
--kind feedback --key feedback-1 --stdin --json
uv run dc session replay chat-1
uv run dc session show chat-1
uv run dc session list --status open --since 2026-10-01
uv run dc session close chat-1
uv run dc memory worker --once
uv run dc memory proposalsSet DOCLING_CONTEXT_SESSION=chat-1 to omit the ID from session append, or
use --text when sending a short event without stdin. session close prevents
new events and queues compilation of the final revision. session jobs ID and
memory jobs ID show compilation outcomes. memory worker polls for jobs;
--once handles one due job and exits. Queued jobs for older session revisions
become superseded when a newer revision is queued.
session list filters by --status open|closed and --since/--until ISO
dates or timestamps. session trim ID --keep-last N creates a shorter current
revision. Use session attachment ID KEY --output FILE to save one attached
event payload.
uv run dc memory list --kind preference --status proposed
uv run dc memory show MEMORY_URI --json
uv run dc memory accept MEMORY_URI
uv run dc memory search 'concise replies'
uv run dc memory recall 'concise replies' --session chat-1
uv run dc memory correct MEMORY_URI 'I prefer brief answers'
uv run dc memory reject MEMORY_URI --reason 'Incorrect inference'
uv run dc memory delete MEMORY_URI
uv run dc memory purge MEMORY_URImemory list includes every non-purged status by default, including rejected
and deleted claims. Filter it by --status, --kind, --since, or --until.
memory proposals is a shortcut for proposed claims. memory create KIND CLAIM
creates a user-authored proposal; --accepted accepts it immediately. Optional
source citations require all four flags: --source-uri,
--source-document-id, --source-revision-id, and --source-xpath.
memory search and memory recall return accepted claims only. Recall records
which memory revision was delivered to a session and suppresses repeats.
delete withdraws an item from normal use while retaining its history. purge
removes that item's stored revisions and content. Both commands are scoped to
the selected tenant and user.
| Command | Immediate effect | What remains |
|---|---|---|
dc session delete ID |
Removes the current session from session list, show, and replay. |
Historical revisions and their attachments remain stored; compilation jobs and the session's recall ledger remain. |
dc session purge ID |
Deletes the session if necessary, then removes its revision records, attachments, compilation jobs, and recall ledger. | Derived memories are separate packages. The change outbox retains operation metadata. |
dc memory delete URI |
Writes a new revision with status deleted. The claim leaves memory search and recall. |
The current claim and review history remain visible through memory show URI and memory list --status deleted; older revisions remain stored. |
dc memory purge URI |
Removes a previously deleted claim's current package, revisions, search index entries, provenance links, and recall records. | The source session or document and change outbox metadata remain. |
memory purge requires memory delete first. session purge can be called on
an active or previously deleted session. Removing a source session causes
dependent accepted memories with no other surviving citation to return to
proposed for review; it does not purge those memory packages. Purging a memory
does not erase its wording from a cited session or document. If that source is
later compiled again, it can produce a new proposal.
Package blobs are content addressed and are removed by purge only when no remaining revision references them. The outbox retains earlier put/delete identifiers and operation metadata; purge does not clear it. Purge removes the item's stored content and revisions, but does not erase every related record.
find and grep are case-insensitive substring scans of current documents.
They scan at most 1,000 documents, 2,000 nodes per document, and 50,000 nodes
total, returning at most 100 hits. They accept
an optional URI subtree scope and enforce tenant and user access. They do not
yet provide embedding search or relevance ranking. When scoped to memory
packages, they skip claims that are not accepted.
search uses the SQLite retrieval index and returns exact DCLX citations.
New or changed documents are indexed during ingestion. index status reports
both lexical and vector coverage. index lex status and index vector status
show each index separately. index lex rebuild regenerates the SQLite index
from stored DCLX packages without rerunning conversion or OCR. It invalidates
an existing vector snapshot; a configured embedding provider rebuilds it on its
next use. Status and lexical rebuild honor the selected tenant and user scope.
The CLI defaults to lexical search until a vector model has been built, then
uses hybrid search. --mode lexical|vector|hybrid selects a mode explicitly.
Install the vectors extra and run dc index vector rebuild to generate
embeddings with the local default BAAI/bge-small-en-v1.5 model.
--model MODEL selects another supported FastEmbed text model;
Qdrant/clip-ViT-B-32 selects paired
text and image encoders. The first build downloads model weights unless
--offline is passed. On Apple Silicon, --backend auto selects MLX for
supported BGE models and uses ONNX for other models. Use --backend mlx or
--backend onnx to choose explicitly. MLX uses separate model weights and
cannot be combined with --offline; --backend auto --offline uses ONNX.
The selected backend is saved with the vector generation, so subsequent
searches use the same encoder. Both lexical and vector rebuilds display a
progress bar on interactive terminals; progress goes to stderr.
After a vector build, document writes and deletes replay from the outbox on
the next vector search. Missing or corrupt snapshots trigger a full rebuild.
dc index vector status reports embedding coverage and the
stored model. search --image PATH --mode vector accepts an image query with
CLIP; text and image may be supplied together. A text-only model skips the
image input. Vector builds currently require all documents in the store to be
accessible to the selected principal because the snapshot is store-wide.
With an image-capable model, referenced picture assets are indexed alongside
text nodes. Search results include the picture XPath and asset path; image-only
results show an image marker in the table. After upgrading an existing store,
run dc index lex rebuild and dc index vector rebuild to add picture assets.
Use --uri, --document, and --xpath to restrict scope; repeat --tier
to select context tiers. -k, --max-tokens, and --per-result-tokens
control output size. It prints a compact table by default; pass --json for
full citation records. See scoped retrieval for the Python
vector and hybrid API.