🧠 NeuroSearch

Intelligent Terminal-Based File Search & Real-Time Monitoring Tool
Designed for developers, sysadmins, hackers, nerds, and anyone who likes to see inside the machine.

---

🚀 Features

• 🔍 Smart Search Engine
  Search files by:

  • Name patterns (*.log, regex etc.)
  • Size filters (>1KB, <10MB)
  • Modification date (--modified-after)
  • Text content inside files (even across encodings)

• 📡 Real-Time Watch Mode
  Monitor directories for new or modified files, and trigger live alerts when matches occur.

• 🧠 Session Intelligence

  • Search history tracking
  • Config persistence across runs
  • Favorite patterns (coming soon)

• 🎨 Nerd/Geek Aesthetic

  • Beautiful terminal UI with Rich
  • Colorful panels, dimmed logs, and event transparency
  • Designed to feel like a tool for smart, sharp hackers

• 🪵 Debugging Transparency

  • See pattern/filter/content mismatches in live time
  • Monitor event counts and session stats

• 💾 Output Modes

  • print to terminal (with optional table view)
  • file to save .txt result logs
  • clipboard (for nerds who live in Ctrl+V)

---

⚙️ Installation

✅ Requirements

• Python 3.7+
• pip packages:

  pip install rich watchdog pyperclip

Usage

🔍 Basic File Search

  python neuro.py --path ./logs --pattern "*.log"

🧑‍💻 Usage

🔍 Basic File Search

python neuro.py --path ./logs --pattern "*.log"

🔎 Search with Filters

python neuro.py --path /var/www --pattern "*.php" --size ">50KB" --modified-after 2024-01-01

🔬 Search by Content

python neuro.py --path ./src --pattern "*.py" --content "def main"

📊 Search with Progress & Details

python neuro.py --path ./data --pattern "*.csv" --progress --details

📡 Real-Time Monitoring

python neuro.py --path ./watch --pattern "*.txt" --watch

💡 With Debug Enabled

python neuro.py --path ./watch --pattern "*.txt" --watch --debug

The system will also do an initial scan to show existing matching files before going live.

---

📁 Output Examples

📡 Real-Time Monitor
Monitoring: ./watch
Pattern: *.txt
Debug: ON

🔄 MODIFIED: notes.txt
⛔ Filter mismatch: tiny.txt
✅ CREATED: Code/large_notes.txt | 2.1KB | 2025-07-06 13:42

---

🧠 Config Persistence

NeuroSearch stores your preferences in:

~/.neurosearch_config.json

Which includes:

• 🔁 Search history (last 50)
• 🧩 Output mode (print, clipboard, file)
• 🐞 Debug settings

---

🧪 Example Use Cases

• Monitor logs and alert when size exceeds limit
• Search your dev folder for functions across Python scripts
• Track real-time events inside a changing directory
• Pipe results into other tools via clipboard or saved output

---

🔮 Future Add-ons (Ideas)

• 🧱 Search profiles via .neuroprofile.json
• 🧠 AI file summarizer (--ai-summary)
• 📦 CLI package (pip install neurosearch)
• 🖼 Terminal GUI mode using Textual

---

🤖 Contributing

Pull requests are welcome. Feel free to fork and improve — especially if you're into cool terminal tooling.

---

🧠 Philosophy

"Search shouldn’t feel like an afterthought. It should feel like controlling the matrix — with purpose, speed, and intelligence."

---

Made by Me. NeuroSearch