@vd7/eyecli 0.1.8

package/.git-personal-enforced

@@ -0,0 +1,3 @@
+# This repository enforces personal git config only
+ENFORCED_DATE=2026-01-07
+REQUIRED_CONFIG=personal

package/README.md

@@ -0,0 +1,173 @@
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/vdutts7/webp/refs/heads/main/eyecli.webp" alt="logo" width="80" height="80" />
+<img src="https://raw.githubusercontent.com/vdutts7/webp/refs/heads/main/npm.webp" alt="logo" width="80" height="80" />
+
+<h1 align="center">👁️ eyecli</h1>
+<p align="center"><i><b>The Eye sees EVERYTHING. A powerful search CLI wrapping ripgrep and fd.</b></i></p>
+
+[![Github][github]][github-url]
+[![npm][npm]][npm-url]
+
+</div>
+
+<br/>
+
+## Table of Contents
+
+<ol>
+    <a href="#about">📝 About</a><br/>
+    <a href="#install">💻 Install</a><br/>
+    <a href="#usage">🚀 Usage</a><br/>
+    <a href="#ignore-file">📄 Ignore File</a><br/>
+    <a href="#roadmap">🗺️ Roadmap</a><br/>
+    <a href="#tools-used">🔧 Tools used</a><br/>
+    <a href="#contact">👤 Contact</a>
+</ol>
+
+<br/>
+
+## 📝About
+
+Smart defaults for searching. Hidden files included, case-insensitive, no .gitignore restrictions.
+
+- **🔍 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
+
+<br/>
+
+## 💻Install
+
+```bash
+npm i -g @vd7/eyecli
+```
+
+### Requirements
+
+- [ripgrep](https://github.com/BurntSushi/ripgrep) - for content search
+- [fd](https://github.com/sharkdp/fd) - for filename search
+
+```bash
+# macOS
+brew install ripgrep fd
+
+# Ubuntu/Debian
+apt install ripgrep fd-find
+
+# Windows
+choco install ripgrep fd
+```
+
+<br/>
+
+## 🚀Usage
+
+```bash
+# 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
+```
+
+### Examples
+
+```bash
+# 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
+```
+
+<br/>
+
+## 📄Ignore File
+
+Eye supports a `~/.eyeignore` file to customize what gets searched.
+
+```bash
+# 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.
+
+<br/>
+
+## 🗺️Roadmap
+
+- [x] Content search with ripgrep
+- [x] Filename search with fd
+- [x] Extension filtering (`:json`, `:ts,tsx`)
+- [x] Tree view output
+- [x] Custom ignore file (`~/.eyeignore`)
+- [ ] Fuzzy matching
+- [ ] Interactive mode
+- [ ] Config file for defaults
+
+<br/>
+
+## 🔧Tools Used
+
+[![Node.js][nodejs-badge]][nodejs-url]
+[![ripgrep][rg-badge]][rg-url]
+[![fd][fd-badge]][fd-url]
+
+<br/>
+
+## 👤Contact
+
+[![Email][email]][email-url]
+[![Twitter][twitter]][twitter-url]
+
+<!-- BADGES -->
+[github]: https://img.shields.io/badge/💻_eyecli-000000?style=for-the-badge
+[github-url]: https://github.com/vdutts7/eyecli
+[npm]: https://img.shields.io/badge/npm-@vd7/eyecli-CB3837?style=for-the-badge&logo=npm
+[npm-url]: https://www.npmjs.com/package/@vd7/eyecli
+[nodejs-badge]: https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white
+[nodejs-url]: https://nodejs.org
+[rg-badge]: https://img.shields.io/badge/ripgrep-4B275F?style=for-the-badge&logo=rust&logoColor=white
+[rg-url]: https://github.com/BurntSushi/ripgrep
+[fd-badge]: https://img.shields.io/badge/fd-4B275F?style=for-the-badge&logo=rust&logoColor=white
+[fd-url]: https://github.com/sharkdp/fd
+[email]: https://img.shields.io/badge/Email-000000?style=for-the-badge&logo=Gmail&logoColor=white
+[email-url]: mailto:me@vd7.io
+[twitter]: https://img.shields.io/badge/Twitter-000000?style=for-the-badge&logo=Twitter&logoColor=white
+[twitter-url]: https://x.com/vdutts7

package/TODOs.md

@@ -0,0 +1,10 @@
+# TODOs
+
+<!-- macos-trace: traces fd can't see (path-only) -->
+- [ ] Keychain (binary; refs in label/service) → Keychain Access or `security dump-keychain … | strings | grep -i PATTERN`
+- [ ] SQLite/.vscdb/.db (path in column, not filename) → `rg -i -l PATTERN ~/Library --glob '*.{sqlite,vscdb,db}'`
+- [ ] Plists/caches (path embedded in content) → `rg -i -l PATTERN ~/Library` (slow)
+- [ ] Add `--content` or keychain/DB pass to trace (or separate script)
+<!--  -->
+
+<!-- same for rg as for fd -->

package/bin/eye.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+// Default flags (mirrors ~/.zshrc RG_DEFAULTS and FD_DEFAULTS)
+const RG_DEFAULTS = ['--hidden', '--no-follow', '--no-ignore', '-i'];
+const FD_DEFAULTS = ['-H', '-L', '--no-ignore'];
+
+// Parse arguments
+const args = process.argv.slice(2);
+
+// Help
+if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+  console.log(`
+👁️  EYE - The Eye sees EVERYTHING
+
+Usage:
+  eye <pattern> [path]           Search file contents (via ripgrep)
+  eye -f <pattern> [path]        Search filenames (via fd)
+  eye :ext [path]                Find files by extension (e.g., eye :json .)
+  eye :ext1,ext2 [path]          Multiple extensions (e.g., eye :js,ts ~/code)
+
+Options:
+  -f, --files      Search filenames instead of content
+  -a, --all        Include binary files
+  -c, --count      Count results
+  -t, --tree       Show results as tree
+  -E <glob>        Exclude paths matching glob (repeatable)
+  -h, --help       Show this help
+
+Examples:
+  eye "TODO" .                   Find TODO in current directory
+  eye "function" ~/code          Search for "function" in ~/code
+  eye -f "config" ~/projects     Find files named "config"
+  eye :json ~/projects           Find all .json files
+  eye :ts,tsx src -c             Count TypeScript files in src
+
+Requirements:
+  - ripgrep (rg) for content search
+  - fd for filename search
+
+Install dependencies:
+  brew install ripgrep fd        # macOS
+  apt install ripgrep fd-find    # Ubuntu/Debian
+`);
+  process.exit(0);
+}
+
+// Check for required tools
+function checkTool(name, altName) {
+  const { execSync } = require('child_process');
+  try {
+    execSync(`which ${name}`, { stdio: 'ignore' });
+    return name;
+  } catch {
+    if (altName) {
+      try {
+        execSync(`which ${altName}`, { stdio: 'ignore' });
+        return altName;
+      } catch {
+        return null;
+      }
+    }
+    return null;
+  }
+}
+
+// Parse arguments
+let mode = 'content';
+let includeBinary = false;
+let countMode = false;
+let treeMode = false;
+let pattern = null;
+let searchPath = '.';
+let excludes = [];
+let extensions = [];
+
+let i = 0;
+while (i < args.length) {
+  const arg = args[i];
+  
+  if (arg === '-f' || arg === '--files') {
+    mode = 'files';
+  } else if (arg === '-a' || arg === '--all') {
+    includeBinary = true;
+  } else if (arg === '-c' || arg === '--count') {
+    countMode = true;
+  } else if (arg === '-t' || arg === '--tree') {
+    treeMode = true;
+  } else if (arg === '-E' || arg === '--exclude') {
+    i++;
+    if (args[i]) excludes.push(args[i]);
+  } else if (arg.startsWith(':')) {
+    // Extension filter :json or :js,ts
+    const exts = arg.slice(1).replace(/\s/g, '').split(',');
+    extensions.push(...exts.filter(e => e));
+  } else if (!pattern && extensions.length === 0) {
+    // Only set pattern if no extensions (extensions don't need a pattern)
+    pattern = arg;
+  } else {
+    searchPath = arg;
+  }
+  i++;
+}
+
+// If only extensions specified, use match-all pattern
+if (extensions.length > 0 && !pattern) {
+  pattern = '.';
+}
+
+if (!pattern && extensions.length === 0) {
+  console.error('Error: No pattern specified. Use --help for usage.');
+  process.exit(1);
+}
+
+// Build command
+let cmd, cmdArgs;
+
+if (mode === 'files' || extensions.length > 0) {
+  // Filename search via fd
+  const fdCmd = checkTool('fd', 'fdfind');
+  if (!fdCmd) {
+    console.error('Error: fd not found. Install with: brew install fd');
+    process.exit(1);
+  }
+  
+  cmd = fdCmd;
+  cmdArgs = [...FD_DEFAULTS];
+  
+  // Add extensions
+  for (const ext of extensions) {
+    cmdArgs.push('-e', ext);
+  }
+  
+  // Add excludes (handle absolute vs relative paths)
+  for (const ex of excludes) {
+    if (ex.startsWith('/')) {
+      cmdArgs.push('--exclude', ex);
+    } else {
+      cmdArgs.push('--exclude', `*${ex}*`);
+    }
+  }
+  
+  // Add pattern (use '.' as match-all if only extensions specified)
+  if (extensions.length > 0) {
+    cmdArgs.push('.');
+  } else if (pattern) {
+    cmdArgs.push(pattern);
+  }
+  
+  // Add search path
+  cmdArgs.push(searchPath);
+  
+} else {
+  // Content search via rg
+  const rgCmd = checkTool('rg');
+  if (!rgCmd) {
+    console.error('Error: ripgrep not found. Install with: brew install ripgrep');
+    process.exit(1);
+  }
+  
+  cmd = rgCmd;
+  cmdArgs = [...RG_DEFAULTS];
+  
+  if (includeBinary) cmdArgs.push('-a');
+  if (countMode) cmdArgs.push('-c');
+  
+  // Add excludes (handle absolute vs relative paths)
+  for (const ex of excludes) {
+    if (ex.startsWith('/')) {
+      cmdArgs.push('--glob', `!${ex}/**`);
+    } else {
+      cmdArgs.push('--glob', `!**/${ex}/**`);
+    }
+  }
+  
+  cmdArgs.push(pattern, searchPath);
+}
+
+// Execute
+const child = spawn(cmd, cmdArgs, { stdio: 'inherit' });
+
+child.on('error', (err) => {
+  console.error(`Error: ${err.message}`);
+  process.exit(1);
+});
+
+child.on('close', (code) => {
+  process.exit(code || 0);
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@vd7/eyecli",
+  "version": "0.1.8",
+  "description": "The Eye sees EVERYTHING. A powerful search CLI wrapping ripgrep and fd with smart defaults.",
+  "main": "index.js",
+  "bin": {
+    "eye": "bin/eye.js"
+  },
+  "scripts": {
+    "test": "node bin/eye.js --help"
+  },
+  "keywords": [
+    "search",
+    "ripgrep",
+    "fd",
+    "find",
+    "grep",
+    "cli",
+    "files",
+    "content"
+  ],
+  "author": "vdutts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vdutts/eyecli.git"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "ripgrep": "*",
+    "fd-find": "*"
+  },
+  "peerDependenciesMeta": {
+    "ripgrep": {
+      "optional": true
+    },
+    "fd-find": {
+      "optional": true
+    }
+  }
+}