# Autorag Setup

Install and configure AutoRAG, register its Lite MCP server for external agents, or...

- Repository: https://github.com/Marker-Inc-Korea/AutoRAG (5251 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Marker-Inc-Korea/AutoRAG --skill autorag-setup -g -a claude-code -y`
Codex: `npx skills add Marker-Inc-Korea/AutoRAG --skill autorag-setup -g -a codex -y`
Cursor: `npx skills add Marker-Inc-Korea/AutoRAG --skill autorag-setup -g -a cursor -y`
Gemini CLI: `npx skills add Marker-Inc-Korea/AutoRAG --skill autorag-setup -g -a gemini-cli -y`

## Description

Install and configure AutoRAG, register its Lite MCP server for external agents, or repair its single search model, approved roots, indexes, datasources, and health checks without exposing credentials. Use when AutoRAG or MCP is missing, init/refresh/health fails, indexes are stale, or the user wants to add folders or datasources.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

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

The rest: https://github.com/Marker-Inc-Korea/AutoRAG/blob/HEAD/skills/autorag-setup/SKILL.md