>_

spot

agent-ready non-interactive

Tiny file search utility (bash)

How to install spot

npm install -g spot

spot use case

Search for text patterns in files within a directory tree, with smart defaults for case, quoting, and target paths.

When to use spot

  • When you need a fast, Bash-based grep alternative with sensible defaults
  • When you want case-insensitive searches that automatically become case-sensitive when you use uppercase
  • When you want to search files without worrying about escaping quotes or special characters

When not to use spot

  • When you need full regular expression support beyond simple wildcard (dot) matching
  • When you need to search binary files or include hidden directories like .git

spot features

  • · Smart phrases (no need to wrap search in quotes)
  • · Smart case (case-insensitive by default, sensitive if uppercase included)
  • · Smart targets (first argument with slash constrains search to directory)
  • · Wildcard matching (dot acts as regex wildcard)
  • · Line abbreviation for long lines

Want your agent to find this automatically?

Add the MCP server to your agent config and it will discover tools like spot on its own.

Set up MCP →

Similar tools to spot