butchokoy25 RAG Query — Personal Knowledge Graph
Query your personal LightRAG knowledge graph to recall decisions, preferences, project context, and learnings from past sessions.
Query Modes
| Mode | When to use | What it does |
|---|---|---|
hybrid (default) |
Most queries | Combines local entity relationships + global topic summaries |
local |
"What's related to X?" | Traverses entity relationships from specific nodes |
global |
"What do you know about topic Y?" | Summarizes across all documents on a topic |
naive |
Simple keyword lookup | Basic text search, fastest but least intelligent |
How to query
Full query (returns answer)
node -e "
const BASE = process.env.LIGHTRAG_SERVER_URL || 'http://YOUR_LIGHTRAG_HOST:YOUR_PERSONAL_PORT';
(async () => {
const auth = await fetch(BASE + '/auth-status').then(r => r.json());
const token = auth.access_token;
const res = await fetch(BASE + '/query', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ' + token
},
body: JSON.stringify({
query: 'QUERY_HERE',
mode: 'hybrid'
})
});
const data = await res.json();
console.log(JSON.stringify(data, null, 2));
})();
"
Context-only query (returns raw context for Claude to synthesize)
node -e "
const BASE = process.env.LIGHTRAG_SERVER_URL || 'http://YOUR_LIGHTRAG_HOST:YOUR_PERSONAL_PORT';
(async () => {
const auth = await fetch(BASE + '/auth-status').then(r => r.json());
const token = auth.access_token;
const res = await fetch(BASE + '/query', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ' + token
},
body: JSON.stringify({
query: 'QUERY_HERE',
mode: 'hybrid',
only_need_context: true
})
});
const data = await res.json();
console.log(typeof data === 'string' ? data : JSON.stringify(data, null, 2));
})();
"
Response format
When presenting results to the user:
- Be concise — summarize, don't dump raw JSON
- Cite the source type when relevant (e.g., "from a stored decision on 2026-03-15")
- Flag potentially stale information (anything >30 days old)
- If no results found, say so clearly — don't fabricate
Infrastructure
- Server:
YOUR_LIGHTRAG_HOST:YOUR_PERSONAL_PORT - Auth: Bearer token from
/auth-status(guest/disabled mode) - Env var:
LIGHTRAG_SERVER_URL