Search documentation of Ragex

# mix ragex.cache.refresh (Ragex v0.4.0)

View Source

Refreshes the embeddings cache for the current project.

## Usage

    mix ragex.cache.refresh [options]

## Options

    --full          Perform full refresh (re-analyze all files)
    --incremental   Perform incremental refresh (default, only changed files)
    --path PATH     Directory to refresh (default: current directory)
    --stats         Show statistics after refresh

## Examples

    # Incremental refresh (default)
    $ mix ragex.cache.refresh

    # Full refresh (re-analyze everything)
    $ mix ragex.cache.refresh --full

    # Refresh specific directory
    $ mix ragex.cache.refresh --path lib/

    # Show statistics after refresh
    $ mix ragex.cache.refresh --stats

## Description

This task refreshes the embeddings cache by analyzing files in the project. By default, it performs an incremental refresh, only re-analyzing files that have changed since the last analysis.

### Incremental Mode (default)

- Checks file content hashes to detect changes
- Skips unchanged files (reads from cache)
- Only regenerates embeddings for changed entities
- Typically <5% regeneration on single-file changes

### Full Mode (--full)

- Re-analyzes all files from scratch
- Regenerates all embeddings
- Useful after model changes or cache corruption
- Takes longer but ensures consistency