autorag

AutoRAG Librarian Skill

Use this skill when AutoRAG is already configured and the user asks to search, summarize, compare, or answer questions from local PDFs, wikis, notes, research papers, knowledge bases, or configured datasources.

AutoRAG is the specialized librarian agent. One configured model plans the search, calls MinSync, Jikji, datasource, and filesystem tools, reads sources, judges evidence, and curates the final answer. There is no subagent or separate model role.

AutoRAG reads source documents and writes indexes only under the configured workspace .autorag/ directory and Jikji's central store (<OS data dir>/jikji/, plus a .jikji_agent_map.md guide in each indexed root). Never move, rename, edit, or delete source files.

Preflight

Confirm a config exists at --config, AUTORAG_CONFIG, $AUTORAG_HOME/config.json, or ~/.autorag/config.json. Inspect only non-secret searchPaths and model metadata, then run:

autorag duplicates --json
autorag status --json
autorag health --json

Duplicate-file review

Use autorag duplicates when the user asks to find duplicate files, choose likely latest copies, or reduce corpus/index space. The command and the scan_duplicate_documents Agent tool are read-only and never delete or move source files. Exact means dupey's canonical extracted-text hash matches; near/contains families require human review. Exact duplicate exclusion during refresh is enabled by default and can be disabled with "excludeExactDuplicates": false in config.json.

Excluding local files from the index

"excludePaths" in config.json lists files or folders (absolute, or relative to workspacePath) that refresh keeps out of the parsed mirror and MinSync. A folder entry excludes everything under it. Removing an entry and running autorag refresh --method minsync indexes the file again. Excluded sources are recorded as user-excluded skips, so they are not reported as stale. Jikji indexes the source folders directly and is not refreshed here, so AutoRAG also drops excluded paths from the jikji_find answer pack and the baseline prefetch at retrieval time; the on-disk .jikji_agent_map.md stays complete, and direct file reads remain available.