# RAG Query

> Query the personal LightRAG knowledge graph for persistent memory across sessions

- Skill: `butchokoy25/rag-query` (Agent Skill)
- Install (CLI): `npx skillmds@latest add butchokoy25/rag-query`
- Raw SKILL.md: https://api.skillmd.com/api/skills/butchokoy25/rag-query/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: butchokoy25 (https://skillmd.com/u/butchokoy25)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/butchokoy25/rag-query

---


# 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)

```bash
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)

```bash
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`