scout

Search files by name or pattern and inspect directory trees with git status.

2|Updated Sep 12, 2016

Search Tags:#search #filesystem #fd #rg #tree-view #hidden-files

Ready to run

npx skills add https://github.com/paulnsorensen/dotfiles --skill scout-paulnsorensen

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: scout
Source: https://github.com/paulnsorensen/dotfiles/tree/main/claude/skills/scout
Command: npx skills add https://github.com/paulnsorensen/dotfiles --skill scout-paulnsorensen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scanning large codebases to locate files and understand directory structures can be time-consuming. scout streamlines this by leveraging ripgrep, fd, and ls to search, filter, and visualize results quickly.

Core Features & Use Cases

Fast file discovery by name or extension using fd
Content search across files with rg, respecting .gitignore by default and offering aliases
Directory trees with git status using ls (eza)
Works with hidden and ignored files when needed
Use cases include locating config files, auditing code, or visualizing project layout

Quick Start

Ask me to locate files by name or pattern and show a tree view of a directory

Frequently Asked Questions about scout

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

FAQPage Schema

How do I search and explore files across a filesystem?▼

To search and explore files across a filesystem, use ripgrep, fd, and ls to locate files by name or pattern, inspect directory contents, and view tree structures including hidden files.

What's the best way to locate config files and visualize a project layout?▼

Locating config files and visualizing project layouts is best done by leveraging fd for fast file discovery and ls to generate directory trees that display git status.

Do I need ripgrep and fd installed to search my codebase?▼

Yes, you need ripgrep, fd, and ls installed to search your codebase, as this approach requires these specific tools to run content searches, discover files, and render tree views.

Can I search hidden and ignored files when auditing code?▼

Yes, you can search hidden and ignored files when auditing code, as the content search respects .gitignore by default but offers options to include hidden and ignored files when needed.

How does ripgrep search file contents while respecting gitignore?▼

Ripgrep searches file contents while respecting .gitignore by default to filter out ignored files, and provides alias-based search patterns to streamline finding specific text within files.

How do I view directory trees with git status using ls?▼

To view directory trees with git status, use ls to render visual structures of your project layout that integrate git status indicators directly alongside the file and directory names.