DCLI

DocuMind from your terminal: fast setup, context-aware commands, and JSON mode when you need automation.

Install It Once, Use It Everywhere

DCLI is the command surface for DocuMind. If you like doing real work from the terminal instead of clicking seven panels, this is your page — respectfully.

Need ready-to-paste agent instructions? Use the Agent Integration page for copy-paste prompts and full SKILL.md content.

Global install with pipx (recommended)

git clone https://github.com/mdkaifansari04/documind.git
cd documind
pipx install ./backend

Clone repo, enter root, then install DCLI from backend package.

Point DCLI at local API

export DOCUMIND_API_URL="http://localhost:8000"

DCLI needs the backend URL, otherwise it will shout connection errors at you.

Initialize context

dcli init --namespace-id company_docs

Creates or selects an instance and stores active context for later commands.

Command Reference

Command	Description	Example
`init`	Initialize a new namespace context	`dcli init --namespace-id company_docs`
`context-show`	Display current active context	`dcli context-show`
`context-set`	Set active namespace/instance	`dcli context-set --instance-id <id> --namespace-id company_docs`
`instances`	List all available instances	`dcli instances`
`instance-create`	Create a new instance	`dcli instance-create --name "My Instance" -d "local test"`
`namespaces`	List namespaces	`dcli namespaces --instance-id <id>`
`list-kbs`	List knowledge bases	`dcli list-kbs --instance-id <id>`
`search-docs`	Search documents with query	`dcli search-docs --qr "deploy command" --top-k 5`
`ask-docs`	Ask a question against documents	`dcli ask-docs -qs "How do I deploy?" --top-k 5`
`ingest-text`	Ingest text content into namespace	`dcli ingest-text --content "hello docs" --source-ref inline`

Output Modes

Human mode vs Bot mode

Default output is human-friendly. Add --bot=true to get JSON envelopes (`status`, `data`, `meta`, `text`) for automation and agent usage.

Human mode

dcli search-docs --qr "deploy command" --top-k 5

Bot mode

dcli search-docs --qr "deploy command" --top-k 5 --bot=true

Real Examples

Context sanity check

dcli context-show

First thing to run when results look weird. Half of retrieval bugs are just wrong context.

Ingest content from file

dcli ingest-text --content-file README.md --source-ref readme

Ingest one doc, then immediately query it to validate end-to-end behavior.

Grounded answer with sources

dcli ask-docs -qs "How do I deploy?" --top-k 5

If an answer has no useful sources, treat it like suspicious autocomplete and investigate.