hive.terminal-tools-fs-search

Guides filesystem search using terminal_rg, terminal_glob, and terminal_exec find predicates.

11.0k|5.7k|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/aden-hive/hive --skill hive-terminal-tools-fs-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hive.terminal-tools-fs-search
Source: https://github.com/aden-hive/hive/tree/main/core/framework/skills/_preset_skills/terminal-tools-fs-search
Command: npx skills add https://github.com/aden-hive/hive --skill hive-terminal-tools-fs-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Agents often reach for raw shell commands like grep or find when searching filesystems, producing slow, unstructured, or gitignore-unaware results. This Skill teaches the correct split between structured search tools (terminal_rg for content, terminal_glob for file names) and terminal_exec for predicate queries, tree views, and stat info.

Core Features & Use Cases

  • Content search with terminal_rg: ripgrep-backed, gitignore-aware search with flags for case-insensitivity, context lines, hidden files, multiline regex, file-type filters, and glob scoping across project trees, /var/log, /etc, and home directories.
  • File lookup with terminal_glob: find files by name or glob pattern with automatic pattern widening, recursive matching, and optional inclusion of ignored or hidden files.
  • Predicate queries via terminal_exec: reference tables for find predicates covering mtime, size, type, permissions, and composition with AND/OR logic.
  • Use Case: An agent debugging a production issue searches /var/log case-insensitively for "error" with context lines, then locates all YAML configs under /etc, then finds log files modified in the last day larger than 10MB — each routed to the correct tool.

Quick Start

Ask the agent to find all Python files containing TODO in the project and list log files under /var/log modified in the last two days.

Frequently Asked Questions about hive.terminal-tools-fs-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search file contents with ripgrep in a terminal tool?

Use terminal_rg with a pattern and path, adding flags like ignore_case, context, type_filter, or glob for refinement. It is gitignore-aware and returns structured matches, making it the default for content search in projects or system paths.

When should I use terminal_glob vs terminal_rg?

Use terminal_glob to find files by name or glob pattern, and terminal_rg to search file contents. terminal_glob widens bare stems into recursive substring matches, while terminal_rg wraps ripgrep for pattern matching inside files.

How do I find files by modification time or size?

Predicate queries like mtime, size, or type have no structured wrapper, so use terminal_exec with find directly. For example, find /path -mtime -2 -size +10M -type f locates recent large files.

Why does terminal_rg miss files that grep would find?

ripgrep respects .gitignore and skips hidden files by default. Pass hidden=True to search dotfiles or no_ignore=True to bypass gitignore rules and surface files git would exclude.

What should I use instead of terminal_glob to list one directory?

Use terminal_exec with ls -la /path for a single directory listing. terminal_glob is designed for recursive name-based search, not simple directory enumeration, and tree views should use terminal_exec with tree.