AutoRAG setup

Use this skill when AutoRAG is unconfigured, the autorag CLI is missing, model resolution fails, indexes are missing or stale, or the user wants to change the document collection or datasources.

For model-free external-agent search, use autorag-lite-setup to configure and register autorag-mcp; do not configure a search model or install a search skill for Lite. This skill's model setup and CLI search apply to the full librarian, not the Lite MCP server.

Safety

• Inspect only non-secret provider/model metadata and credential availability.
• Never print, copy, migrate, compare, or persist credential values. Store only environment-variable names such as apiKeyEnv.
• Do not scan the whole filesystem or home directory without explicit approval.
• Setup, indexing, and refresh never move, rename, edit, or delete source documents. The librarian itself may organize files when the user asks it to.
• Do not index system trees, app bundles, caches, credential stores, node_modules, .git, dist, build, target, .cache, .autorag, or .jikji.

Install the CLI if needed

The CLI is @autorag/librarian (autorag). Runtime is Node.js ≥ 24 or Bun.

command -v autorag >/dev/null || bun install -g @autorag/librarian
autorag --help

If Bun is unavailable, npm install -g @autorag/librarian is acceptable.

Inspect existing configuration

Check --config, AUTORAG_CONFIG, $AUTORAG_HOME/config.json, or ~/.autorag/config.json. Relevant fields are:

• searchPaths, workspacePath, and memoryPath
• model.provider, model.id, model.api, model.baseUrl, model.apiKeyEnv
• bm25, minSync, and jikji
• limits (retrieval, baseline-prefetch, and model-facing candidate caps)
• datasources and ui

Preserve explicit user choices and a working config unless the user asks to replace them or health checks fail.

Configure one search model