grepai-trace-callers

Find all code locations that call a specific function using GrepAI trace.

Updated May 12, 2026
One-click install
npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-trace-callers-eduardtomasek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grepai-trace-callers
Source: https://github.com/eduardtomasek/codex-dev-stack/tree/main/skills/.agents/grepai-trace-callers
Command: npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-trace-callers-eduardtomasek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before refactoring, renaming, or changing a function's signature, developers need to know every place that function is called. Manually searching a large codebase is slow and error-prone, and plain text search returns false positives. This Skill uses GrepAI's call-graph tracing to answer "who calls this function?" with precise file, line, and context information. ## Core Features & Use Cases - Caller Tracing: Run grepai trace callers "FunctionName" to list every call site with file path, line number, and surrounding context. - Multiple Output Formats: Human-readable output, --json for scripting, compact JSON for AI token efficiency, and TOON format for ~50% fewer tokens. - Extraction Modes: Choose fast regex-based mode or precise tree-sitter AST parsing for higher accuracy across Go, JavaScript, TypeScript, Python, Rust, Java, C/C++, and more. - Use Case: Before renaming getUserById, run the trace to enumerate all callers, then pipe JSON output through jq to get a unique list of affected files for your refactor plan. ## Quick Start Ask the AI to find all callers of a function, for example: "Use grepai trace callers to show me everywhere the Login function is called in this repository."

Frequently Asked Questions about grepai-trace-callers

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

FAQPage Schema
How do I find all callers of a function in my codebase?▼

Run grepai trace callers followed by the function name, such as grepai trace callers "Login". It returns each call site with the caller function name, file path, line number, and surrounding code context.

How to get grepai trace results as JSON for scripting?▼

Add the --json flag to get machine-readable output, or --json --compact for a token-efficient variant. You can pipe results to jq, for example to extract unique file paths or count total callers.

What languages does grepai trace callers support?▼

It supports Go, JavaScript, TypeScript, Python, PHP, C/C++, Rust, Zig, C#, Java, and Pascal/Delphi. Enabled languages and exclude patterns are configurable in the trace section of .grepai/config.yaml.

What is the difference between fast and precise trace mode?▼

Fast mode uses regex patterns, is dependency-free, and works well for most cases. Precise mode uses tree-sitter AST parsing for higher accuracy but requires tree-sitter to be installed. Select the mode with --mode fast or --mode precise.

Why does grepai trace callers return no results?▼

Common causes are incorrect function name spelling (matching is case-sensitive), the file type not being in enabled_languages, or a stale symbol index. Run grepai watch to update the index and verify your configuration.

How do I reduce false positives for common function names?▼

Use a more specific function name, add exclude patterns in .grepai/config.yaml, or filter JSON output with jq by file path. Switching to --mode precise also improves accuracy through AST-based parsing.