Skip to main content
command CX Codex

find_and_summarize — Claude Code command: what it does, how to install

find_and_summarize locates source files across target directories and creates concise two-sentence summaries in a YAML file. Useful for documenting modules without subagents.

no license ★ 1,573 updated 2026-02-08

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/find_and_summarize.md
Open on GitHub

What find_and_summarize does

This command inspects project directories recursively to catalog files matching designated extensions. When arguments are omitted, it defaults to scanning '*.vue, *.ts' files in the './apps' directory. The workflow runs directly in the primary session rather than delegating tasks to subagents.

File inspection proceeds in growing chunks. The agent inspects 50 lines first, stepping up to 100 and 200 lines until it understands the purpose of the code. Each entry gets exactly two sentences: one outlining its core functionality, and another detailing where other parts of the project use it.

Summaries are written to app_docs/find_and_summarize_<RUN_NAME>.yaml under a top-level summary key. The app_docs folder must be present beforehand because the command will not create missing folders. Files outside the specified extension patterns remain untouched.

What it helps with

  • catalog file responsibilities across a codebase
  • generate structured YAML documentation for source files
  • trace where specific modules get imported or invoked
  • summarize code without launching secondary subagents

Example prompts for the agent

  • Generate an overview of frontend components: /find_and_summarize web_ui '*.vue' ./apps
  • Summarize all backend endpoints into a documentation file: /find_and_summarize api_audit '*.ts' ./apps
  • Run the file inventory with default settings using /find_and_summarize full_scan

How to install find_and_summarize

Manually: put the files in place

.claude/commands/find_and_summarize.md

Call it with /find_and_summarize. For all projects use ~/.claude/commands/

Questions about find_and_summarize

How do I install find_and_summarize in Claude Code?

Place the command file at .claude/commands/find_and_summarize.md in your repository root.

What does the find_and_summarize command do?

It reads matching codebase files in progressive line chunks and generates a two-sentence summary for each file into a YAML report.

Where does find_and_summarize store the output?

Results are saved to app_docs/find_and_summarize_<RUN_NAME>.yaml, requiring the app_docs directory to already exist in your workspace.

Similar slash commands

All slash commands for Writing and docs →

From the same set20

The whole set →
convert_paths_absolute convert_paths_absolute — a slash command that rewrites relative paths in .claude/settings.json as absolute ones. It helps when command scripts break because they run from the wrong directory. CX Codex +1 ★ 1,573repo stars fetch-docs-haiku45 fetch-docs-haiku45 retrieves online documentation using the Haiku model and saves it as markdown without cuts. CX Codex ★ 1,573repo stars fetch-docs-sonnet45 The fetch-docs-sonnet45 subagent retrieves documentation from a URL and writes it to a chosen file. Use it for documentation retrieval benchmarks. CX Codex ★ 1,573repo stars load_ai_docs load_ai_docs — a command that downloads documentation from AI platforms and saves it as markdown files for agents to reference locally. Use it when you want your sub-agents to have current docs without needing web access. CX Codex +1 ★ 1,573repo stars create-worktree-subagent The create-worktree-subagent subagent creates isolated git worktrees for parallel development. Use it when the request explicitly delegates worktree creation to a subagent. CX Codex ★ 1,573repo stars docs-scraper docs-scraper — a subagent that fetches a documentation page by URL and saves it as a markdown file in ai_docs/. Handy when your agent needs a local copy of the docs. CX Codex ★ 1,573repo stars quick-plan quick-plan turns requirements into structured implementation blueprints stored in the specs/ folder. Useful before starting complex refactoring or new feature work. CX Codex +1 ★ 1,573repo stars plan_new_feature plan_new_feature is a Claude Code command that turns a feature request into a development plan saved under specs/. It maps the work before coding starts. CX Codex +1 ★ 1,573repo stars

Project sponsors

Companies that keep this analytics open