Skip to content
Get packs

Filesystem Search Tools

Teaches an agent to search files and folders with ripgrep and glob tools instead of raw shell commands.

Source Download skill
Repository
aden-hive/hive
Stars
11,132
Licence
Apache-2.0
Files
3 files

What it does

When installed, this skill tells the agent which built-in search tool to pick for a file task. It uses terminal_rg to search file contents (fast, skips gitignored files by default), terminal_glob to find files by name, and falls back to plain shell commands like find, ls, tree, stat and du for things like modification-date or size filters and directory views. It also explains the common search flags and how to read truncated results.

Great for

  • Developers who want an agent to search a codebase or log folder accurately and quickly
  • Engineers debugging by searching logs in /var/log or config files in /etc
  • Anyone using the Hive agent framework who wants consistent file-search behaviour

Skip it if

  • Users without the Hive terminal tools installed, since the skill only describes tools that must already exist in the runtime
  • Searches that must be exhaustive when ripgrep is missing: the approximate fallback ignores .gitignore and can give incomplete inventories
  • Sensitive directories such as home folders or system configs, where the agent could read secrets like API keys; review what paths the agent is allowed to search

Try asking

  • “Find every Python file in this project that contains the word TODO”
  • “Search /var/log for the word error from the last few runs, with two lines of context”
  • “Find the config file named lk_scan_post_reactors anywhere under core/framework/skills”
  • “Show a two-level tree of this project and the disk usage of its largest folders”
Step-by-step guide: how to use Filesystem Search ToolsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 3 original files, the Apache-2.0 licence and an attribution note.

    terminal-tools-fs-search.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip terminal-tools-fs-search.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip terminal-tools-fs-search.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask for a specific path and file type (for example, only *.py under src) to keep results small and avoid truncation.
  • If results are marked truncated, narrow the pattern or path rather than raising limits.
  • Confirm ripgrep is installed before relying on search completeness; check for the ripgrep_required error.

What's inside

  • references/find_predicates.md
  • references/ripgrep_cheatsheet.md
  • SKILL.md

Redistributed unmodified from aden-hive/hive under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.