👁️ eyecli

The Eye sees EVERYTHING. A powerful search CLI wrapping ripgrep and fd with smart defaults.

Install

npm install -g @vd7/eyecli

Requirements

• ripgrep - for content search
• fd - for filename search

# macOS
brew install ripgrep fd

# Ubuntu/Debian
apt install ripgrep fd-find

# Windows
choco install ripgrep fd

Usage

# Search file contents
eye "pattern" [path]

# Search filenames
eye -f "pattern" [path]

# Find by extension
eye :json .
eye :ts,tsx ~/code

# Options
eye -c "pattern" .        # Count matches
eye -t :json .            # Tree view
eye -E node_modules "TODO" .  # Exclude paths

Ignore File

Eye supports a ~/.eyeignore file to customize what gets searched.

# Create starter ignore file
eye init

This creates ~/.eyeignore with sensible defaults (node_modules, .git, build dirs, etc.). Edit it to customize.

Starter template includes:

• Version control (.git, .svn)
• Dependencies (node_modules, vendor)
• Build output (dist, build, out)
• Lock files (package-lock.json, yarn.lock)
• IDE files (.idea, .vscode)
• Caches (pycache, .cache)
• And more...

Secrets are NOT ignored by default - uncomment .env patterns in ~/.eyeignore if you want to exclude them.

Examples

# Find all TODOs in current directory
eye "TODO" .

# Find config files
eye -f "config" ~/projects

# Find all JSON files
eye :json ~/projects

# Count TypeScript files
eye :ts,tsx src -c

# Search excluding node_modules
eye -E node_modules "import" .

# Create ignore file
eye init

Why?

• 🔍 Smart defaults - hidden files included, case-insensitive, no .gitignore restrictions
• 🚀 Fast - powered by ripgrep and fd
• 📁 Extension filter - :json, :ts,tsx syntax for quick file type filtering
• 🌳 Tree view - visualize results as directory tree
• ⚙️ Customizable - ~/.eyeignore for personal ignore patterns

License

MIT