Search

Search across all your notes by file name or content.

Quick Open

Press Ctrl+k to open the search picker. You can search by:

• Files - Search note titles and paths
• Content - Full-text search across all note content

Use ← / → to switch between file and content search modes.

Search Index

Ekphos builds a persistent search index in the background for fast full-text search. The index is:

• Persistent - Saved to disk and loaded on startup
• Incremental - Only re-indexes files that have changed
• Background - Built without blocking the UI

How It Works

Cache Location

The search index is stored in platform-specific cache directories:

Each notes directory gets its own cache folder identified by an 8-character hash of the directory path.

Clearing the Cache

To rebuild the search index from scratch, use the --clean-cache command:

ekphos --clean-cache

This removes all cached search indexes. The index will be automatically rebuilt on next launch.

You can also manually delete the cache directory if needed:

# macOS
rm -rf ~/Library/Caches/ekphos/

# Linux
rm -rf ~/.cache/ekphos/

Sidebar Search

Press / in the sidebar to filter notes by title. This is a quick filter that doesn't use the search index.

Find in Buffer

Press Ctrl+f to search within the current note (similar to vim's / search).

Search Tips

• Word search - Single words match exactly indexed terms
• Phrase search - Multi-word queries search for the exact phrase
• Case insensitive - All searches are case-insensitive
• Partial matches - Words starting with your query are also matched

The search results are ranked by:

1. Exact word matches (highest priority)
2. Title matches (bonus score)
3. Word boundary matches
4. Position in line (start of line gets bonus)