status - Check semantic search index status

Show indexing status, statistics, and configuration for current or specified directory.

Usage

/semq:status [path]

Arguments:

path - Directory to check (optional, defaults to current directory)

What It Does

Finds .odino directory by traversing up from specified path
Runs odino status to show index information
Displays:
- Number of indexed files
- Total chunks generated
- Model name
- Index location
- Last modified date

Examples

Check current directory:

/semq:status

Check specific directory:

/semq:status ~/projects/myapp

Implementation

# Helper function to find .odino directory
find_odino_root() {
    local start_dir="${1:-.}"
    local dir="$(cd "$start_dir" && pwd)"

    while [[ "$dir" != "/" ]]; do
        if [[ -d "$dir/.odino" ]]; then
            echo "$dir"
            return 0
        fi
        dir="$(dirname "$dir")"
    done
    return 1
}

# Get path argument or use current directory
CHECK_PATH="${1:-.}"

# Find index and show status
if ODINO_ROOT=$(find_odino_root "$CHECK_PATH"); then
    echo "Index found at: $ODINO_ROOT"
    echo ""

    # Run status command
    (cd "$ODINO_ROOT" && odino status)
else
    echo "No semantic search index found"
    if [[ "$CHECK_PATH" != "." ]]; then
        echo "Searched from: $CHECK_PATH"
    fi
    echo ""
    echo "To create an index, run:"
    echo "  /semq:index"
fi

Output Example

Index found at: /home/user/project

Indexed files: 63
Total chunks: 142 (529.5 KB)
Model: BAAI/bge-small-en-v1.5
Last updated: 2025-11-15 22:30:45

When to Use

Use /semq:status to:

Check if a directory is indexed
See how many files are indexed
Verify which model is being used
Check when index was last updated
Troubleshoot search issues

/semq:search <query> - Search the index
/semq:index [path] - Create or update index
/semq:here <query> - Search with traversal

Tips

Before searching - Run status to verify index exists
After major changes - Check if reindexing is needed
Troubleshooting - Use status to diagnose search issues
Model verification - Confirm BGE model is being used

Configuration

The index configuration is stored in .odino/config.json:

{
  "model_name": "BAAI/bge-small-en-v1.5",
  "embedding_batch_size": 16,
  "chunk_size": 512,
  "chunk_overlap": 50
}

To change configuration:

Edit .odino/config.json in the indexed directory
Reindex with /semq:index --force

2.7 KiB Raw Blame History