setup

RAG Plugin Setup

Guide the user through first-time setup of the Claude RAG plugin.

Steps

Step 1: Check current config

cat ~/.claude/plugins/claude-rag/config.json 2>/dev/null || echo "NO_CONFIG"

If config exists, show current settings and ask if they want to reconfigure.

Step 2: Choose connection mode

Use AskUserQuestion:

• header: "Claude RAG Setup"
• question: "How do you want to connect to the RAG backend?"
• options:
  • "Local (Docker — for development only)"
  • "Cloud (remote server)"

Step 3: Configure endpoint

If Local:

• Check if Docker is running and the backend is accessible:

  curl -s --max-time 3 https://api.clauderag.io/health
  

• If not accessible, tell the user:

  Start the backend with:
  cd <project-root> && docker compose -f docker/docker-compose.yml up -d
  Then: bun run backend/src/index.ts
  

If Cloud:

• Use AskUserQuestion to get:
  • Endpoint URL
  • API key

Step 4: Write config

Create the config directory and file:

mkdir -p ~/.claude/plugins/claude-rag

Write ~/.claude/plugins/claude-rag/config.json with the chosen settings merged with defaults:

{
  "connection": {
    "endpoint": "<chosen_endpoint>",
    "apiKey": "<if_cloud>"
  },
  "capture": {
    "enabled": true,
    "userPrompts": true,
    "aiOutputs": true,
    "toolCalls": true,
    "toolResults": true,
    "subAgents": true,
    "multimodal": { "copyFiles": true, "maxFileSize": "50MB" },
    "exclude": { "tools": ["AskUserQuestion"], "pathPatterns": ["*.env", "*.secret", "*credentials*"] }
  },
  "rag": {
    "mode": "auto",
    "threshold": 0.6,
    "maxContextTokens": 5000,
    "perPrompt": { "enabled": true, "maxItems": 5, "maxLatencyMs": 500 },
    "sessionStart": { "enabled": true, "maxItems": 3 }
  },
  "privacy": {
    "redactSecrets": true,
    "excludePatterns": ["password", "token", "secret", "api_key", "private_key"]
  }
}

Step 5: Test the connection

curl -s <endpoint>/health