Hive.terminal Tools Fs Search
Use terminal_rg / terminal_glob for all filesystem search, your project tree as well...
Install
npx skills add aden-hive/hive --skill hive.terminal-tools-fs-search -g -a claude-code -y- Repository
- aden-hive/hive11.1k
- Category
- Engineering
- Updated
- 9d ago
- License
- Apache-2.0
- Context cost
- Lightabout 1,424 tokens
- Runs scripts
- No, instructions only
What it does
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.
Filesystem search
terminal-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.
When to use what
| Task | Tool |
|---|---|
| Find code/text matching a pattern (project tree or any path) | terminal_rg (gitignore-aware; defaults to your session workdir) |
| Find files by name/glob (any path) | terminal_glob |
| Find files by mtime/size/type predicate | terminal_exec("find ...") (see references/find_predicates.md) |
| 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 matching lines in returned results | terminal_rg(...).total (check truncated before treating it as complete) |
terminal_rg, content search
ripgrep 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.
Quickstart installs and verifies ripgrep. Existing installations can be repaired with uv run scripts/ensure_ripgrep.py --install from the repository root. The runtime also checks Windows package-manager locations and current registry PATH entries; HIVE_RIPGREP_PATH can select an absolute executable path. Startup logs report the executable and version, or instructions to fix the missing dependency.
