Skip to main content

​
vrin query

Query the knowledge base with natural language. VRIN retrieves relevant facts from your knowledge graph, combines them with matching document chunks, and generates a reasoned response. 
vrin query "What were ACME's key financial metrics in Q4?"

​
Options

FlagShortDefaultDescription
--stream / --no-stream--no-streamStream tokens to stdout as they arrive
--mode-mchatResponse mode: chat, thinking, research
--depth-dQuery depth: basic, thinking, research
--modelLLM model override (e.g., claude-sonnet-4-20250514)
--session-id-sContinue a conversation session
--web-searchfalseEnable web search augmentation
--jsonForce JSON output

​
Response modes

Default mode. Fast, conversational response.
vrin query "What is ACME's revenue?" --mode chat

​
Query depth

Controls how deeply VRIN searches your knowledge graph:
DepthBehaviorBest for
basicFast vector + graph retrievalSimple factual lookups
thinkingCross-document analysis, multi-hop reasoningQuestions connecting multiple sources
researchExhaustive graph traversal, maximum fact coverageComplex analytical queries
vrin query "How do risk factors in our Q3 and Q4 reports compare?" --depth research

​
Streaming

Stream tokens to stdout as they arrive. Metadata is written to stderr after streaming completes. 
vrin query "Summarize our competitive position" --stream
With --json, the full response is buffered and output as JSON after streaming completes: 
vrin query "Summarize our competitive position" --stream --json

​
Conversations

Continue a multi-turn conversation by passing a session ID: 
# Start a conversation
vrin query "What was ACME's Q4 revenue?" --json
# Response includes session_id

# Continue it
vrin query "How does that compare to Q3?" --session-id "sess_abc123"
See conversation commands for managing conversation history.

​
vrin facts

Fast fact retrieval without AI summary generation. Returns raw structured facts from the knowledge graph. Useful for quick lookups or when you want to process facts programmatically. 
vrin facts "ACME revenue"

​
Options

FlagDescription
--jsonForce JSON output

​
Example output (JSON)

vrin facts "ACME revenue" --json

{
  "ok": true,
  "data": {
    "facts": [
      {
        "subject": "ACME Corp",
        "predicate": "reported_revenue",
        "object": "$50M in Q4 2025",
        "confidence": 0.95,
        "source": "ACME Q4 2025 Earnings"
      }
    ],
    "count": 1
  }
}