hive.terminal-tools-fs-search
Use terminal_rg / terminal_find when you need raw filesystem search outside the project tree — system configs, /var/log, /etc, archive contents — or when files-tools.search_files is too project-scoped. Teaches the rg vs find vs terminal_exec("ls/du/tree") split, common rg flag combos for code/logs/configs, find predicates for mtime/size/type queries, and the rule that for tree views or single-file stat info you should just use terminal_exec instead of inventing a tool. Read before reaching for raw shell to grep or find anything.
npx skills add aden-hive/hive --skill terminal-tools-fs-search --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Filesystem search terminal-tools provides two structured search tools: `terminal_rg` (ripgrep for content) and `terminal_find` (find for predicates). Everything else (tree, stat, du) is just `terminal_exec`. ## When to use what | Task | Tool | |---|---| | Find code/text matching a pattern in your **project** | `files-tools.search_files` (project-aware, ranks by relevance) | | Find code/text matching a pattern in `/var/log`, `/etc`, archives, system dirs | `terminal_rg` | | Find files matching name/glob/predicate | `terminal_find` | | List a directory | `terminal_exec("ls -la /path")` | | Tree view | `terminal_exec("tree -L 2 /path")` | | Single-path stat | `terminal_exec("stat /path")` | | Disk usage | `terminal_exec("du -sh /path")` or `terminal_exec("du -h --max-depth=2 /")` | | Count matches across files | `terminal_rg(pattern, count=True via extra_args=["-c"])` | ## `terminal_rg` — content search ripgrep is fast, gitignore-aware, and has a deep flag surface. The structured wrapper exposes the most useful flags directly; `extra_args` covers the rest. ### Common patterns ``` # All Python files containing "TODO" terminal_rg(pattern="TODO", path=".", type_filter="py") # Case-inse
- When to use what
- terminalrg — content search
- Common patterns
- rg flag idioms
- terminalfind — predicate search
- Output truncation
- Anti-patterns
What does the hive.terminal-tools-fs-search skill do?
Use terminal_rg / terminal_find when you need raw filesystem search outside the project tree — system configs, /var/log, /etc, archive contents — or when files-tools.search_files is too project-scoped. Teaches the rg vs find vs terminal_exec("ls/du/tree") split, common rg flag combos for code/logs/configs, find predicates for mtime/size/type queries, and the rule that for tree views or single-file stat info you should just use terminal_exec instead of inventing a tool. Read before reaching for raw shell to grep or find anything.
How do I install it?
Run `npx skills add aden-hive/hive --skill terminal-tools-fs-search --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From aden-hive/hive, a repository with 10,850 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.