← All Projects

Smart Find - Intelligent Find Wrapper

Drop-in replacement for the native find command that auto-excludes build artifacts and noise directories. Zero dependencies, pure bash wrapper working seamlessly with BSD and GNU find across macOS and Linux.

2025•Open Source•Published
View on GitHubView on NPM

Key Features

  • ✓Drop-in replacement: Zero syntax changes, works with existing scripts
  • ✓Intelligent detection: Explicit paths bypass filters automatically
  • ✓User configuration: Add/remove custom ignore directories persistently
  • ✓Multiple bypass options: --raw flag, SMART_FIND=0 env var, or direct /usr/bin/find

Impact

- **Zero dependencies**: Pure bash solution with no runtime requirements - **13+ directories excluded**: Auto-filters node_modules, .git, dist, build, and more - **Cross-platform**: Works with BSD find (macOS) and GNU findutils (Linux) - **AI-optimized**: Speeds up Claude Code and other AI assistant file operations

Technology Stack

Core Stack

BashUnixCLI
  • Pure bash scripting
  • PATH interception technique
  • BSD/GNU find compatibility layer
  • User configuration system

Tags

bashCLIdeveloper-toolsproductivityautomationfilesystemunixmacoslinuxAI-tools