# Do.rag Index

> Build, refresh, inspect, or repair DeepOrbit's machine-local search indexes. Use when notes were synced or moved, retrieval is stale, the user asks to rebuild RAG, or DeepOrbit reports an index problem.

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

---


# Maintain the Local Index

Run one of:

```bash
deeporbit --vault "<vault>" index status
deeporbit --vault "<vault>" index ensure
deeporbit --vault "<vault>" index ensure --semantic
```

The lexical SQLite index is always available and stored outside the vault in the OS cache directory. `--semantic` updates optional ChromaDB and may download an embedding model on first use.

Never commit or synchronize an index. Git and Obsidian Sync carry Markdown and `deeporbit.json`; each device safely rebuilds its own cache. Report added, updated, deleted, and unchanged counts.