gh-cadrianmae-claude-marketplace-plugins-semantic-search/commands/here.md

---
description: Search from current directory upward to find indexed codebase
argument-hint: <query>
allowed-tools: Bash, Read
disable-model-invocation: true
---

# here - Semantic search with directory traversal

Search from current directory upward to find and search the nearest semantic index. Shows where the index was found for transparency.

## Usage

```
/semq:here <query>
```

**Arguments:**
- `query` - Natural language description of what to find (required)

## What It Does

1. Starts from current working directory
2. Traverses up the directory tree looking for `.odino/`
3. Shows where the index was found
4. Runs semantic search from that location
5. Displays results with scores and file paths

**Difference from `/semq:search`:**
- `/semq:search` - Assumes you know where the index is
- `/semq:here` - Explicitly shows index location (useful from subdirectories)

## Examples

**Search from subdirectory:**
```bash
cd src/utils/
/semq:here validation functions
```

**Find authentication from deep directory:**
```bash
cd src/routes/api/v1/
/semq:here authentication logic
```

## Implementation

```bash
# Helper function to find .odino directory with verbose output
find_odino_root_verbose() {
    local dir="$PWD"
    local depth=0

    while [[ "$dir" != "/" ]]; do
        if [[ -d "$dir/.odino" ]]; then
            echo "FOUND:$dir"
            return 0
        fi

        # Stop at git root as a boundary
        if [[ -d "$dir/.git" ]] && [[ ! -d "$dir/.odino" ]]; then
            echo "NOTFOUND:git-boundary:$dir"
            return 1
        fi

        dir="$(dirname "$dir")"
        depth=$((depth + 1))

        # Safety limit
        if [[ $depth -gt 20 ]]; then
            echo "NOTFOUND:max-depth"
            return 1
        fi
    done

    echo "NOTFOUND:filesystem-root"
    return 1
}

# Get query from arguments
QUERY="$*"

if [[ -z "$QUERY" ]]; then
    echo "Error: Query required"
    echo "Usage: /semq:here <query>"
    exit 1
fi

# Show current location
echo "Searching from: $PWD"
echo ""

# Find index with verbose output
RESULT=$(find_odino_root_verbose)
EXIT_CODE=$?

if [[ $EXIT_CODE -eq 0 ]]; then
    ODINO_ROOT="${RESULT#FOUND:}"

    # Show where index was found
    if [[ "$ODINO_ROOT" == "$PWD" ]]; then
        echo "✓ Index found in current directory"
    else
        # Calculate relative path for clarity
        REL_PATH=$(realpath --relative-to="$PWD" "$ODINO_ROOT")
        echo "✓ Index found at: $REL_PATH"
    fi
    echo "  Location: $ODINO_ROOT"
    echo ""

    # Run search
    RESULTS=$(cd "$ODINO_ROOT" && odino query -q "$QUERY" 2>&1)

    if [[ $? -eq 0 ]]; then
        echo "$RESULTS"
        echo ""
        echo "💡 Tip: File paths are relative to: $ODINO_ROOT"
    else
        echo "Search failed:"
        echo "$RESULTS"
    fi
else
    # Parse failure reason
    REASON="${RESULT#NOTFOUND:}"

    echo "✗ No semantic search index found"
    echo ""

    case "$REASON" in
        git-boundary:*)
            GIT_ROOT="${REASON#git-boundary:}"
            echo "Searched up to git repository root: $GIT_ROOT"
            echo "The repository is not indexed."
            ;;
        filesystem-root)
            echo "Searched all the way to filesystem root"
            echo "No index found in any parent directory."
            ;;
        max-depth)
            echo "Reached maximum search depth (20 levels)"
            echo "Index might be higher up or doesn't exist."
            ;;
    esac

    echo ""
    echo "To create an index, navigate to your project root and run:"
    echo "  cd <project-root>"
    echo "  /semq:index"
fi
```

## Output Example

**From subdirectory:**
```
Searching from: /home/user/project/src/utils

✓ Index found at: ../..
  Location: /home/user/project

Score: 0.87 | Path: src/utils/validation.js
Score: 0.81 | Path: src/middleware/validate.js
Score: 0.74 | Path: src/schemas/user.js

💡 Tip: File paths are relative to: /home/user/project
```

**No index found:**
```
Searching from: /home/user/project/src/utils

✗ No semantic search index found
Searched up to git repository root: /home/user/project
The repository is not indexed.

To create an index, navigate to your project root and run:
  cd <project-root>
  /semq:index
```

## When to Use

Use `/semq:here` when:
- Working in a subdirectory
- Want to see where the index is located
- Unsure if directory is indexed
- Want explicit feedback about index location

Use `/semq:search` when:
- Already know the directory is indexed
- Don't need index location info
- Want simpler output

## Behavior

**Traversal stops at:**
1. `.odino/` directory found (success)
2. `.git/` directory without `.odino/` (git repository boundary)
3. Filesystem root `/` (no more parents)
4. 20 levels up (safety limit)

**Why stop at git root?**
- Projects are typically git repositories
- Prevents searching into parent projects
- Makes "not found" more meaningful

## Related Commands

- `/semq:search <query>` - Search without traversal info
- `/semq:status` - Check index status
- `/semq:index` - Create index

## Tips

1. **Use from subdirectories** - That's what this command is for
2. **Check the index location** - Helps understand project structure
3. **Git boundary** - Index should be at git root for best results
4. **Relative paths** - Results show paths relative to index location

## Troubleshooting

**"Searched up to git repository root"**
- The git repository is not indexed
- Solution: Run `/semq:index` from the git root

**"Searched all the way to filesystem root"**
- No index found anywhere in parent directories
- Not in a git repository
- Solution: Create index with `/semq:index`

**"Reached maximum search depth"**
- Very deep directory structure (>20 levels)
- Index might be higher up
- Solution: Navigate closer to project root and try again