hive.terminal-tools-fs-search
Agent skill from
Use terminal_rg / terminal_glob for all filesystem search — your project tree as well as system configs, /var/log, /etc, archive contents. Teaches the rg vs glob vs terminal_exec("find/ls/du/tree") split, common rg flag combos for code/logs/configs, glob patterns for finding files by name, the rule that mtime/size/type predicate queries drop to terminal_exec("find ..."), and 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 to install hive.terminal-tools-fs-search
npx skills add aden-hive/hive# or add only this skill to Claude Code: copy the folder
core/framework/skills/_preset_skills/terminal-tools-fs-search/
# into
~/.claude/skills/terminal-tools-fs-search/ (all projects)
.claude/skills/terminal-tools-fs-search/ (one project)
1# Filesystem search23terminal-tools provides two structured search tools: `terminal_rg` (ripgrep for content) and `terminal_glob` (find files by name/glob). Predicate queries (mtime/size/type) and everything else (tree, stat, du) are just `terminal_exec`.45## When to use what67| Task | Tool |8|---|---|9| Find code/text matching a pattern (project tree or any path) | `terminal_rg` (gitignore-aware; defaults to your session workdir) |10| Find files by name/glob (any path) | `terminal_glob` |11| Find files by mtime/size/type predicate | `terminal_exec("find ...")` (see references/find_predicates.md) |12| List a directory | `terminal_exec("ls -la /path")` |13| Tree view | `terminal_exec("tree -L 2 /path")` |14| Single-path stat | `terminal_exec("stat /path")` |15| Disk usage | `terminal_exec("du -sh /path")` or `terminal_exec("du -h --max-depth=2 /")` |16| Count matching lines in returned results | `terminal_rg(...).total` (check `truncated` before treating it as complete) |1718## `terminal_rg` — content search1920ripgrep is fast, gitignore-aware, and has a deep flag surface. The structured wrapper exposes common search flags directly; `extra_args` accepts additional flags compatible with JSON output. Output modes such as `--count` and `--files-with-matches` are not compatible with this structured interface; use the CLI when that output is needed.21…
Excerpt shown under the repository's Apache-2.0 license.