Map codebases, extract functions, trace calls — 99% fewer tokens than reading files.

./build.sh && ./funcfinder --dir . --all --json > map.json

# Build from source
git clone https://github.com/ruslano69/funcfinder.git
cd funcfinder && ./build.sh

Produces 5 binaries: funcfinder, stat, deps, callgraph, complexity.

C, C++, Go, Rust, D, Java, Kotlin, Scala, JavaScript, TypeScript, PHP, Python, Ruby, Swift, C#

# Map entire codebase
./funcfinder --dir . --all --json > map.json

# Find function
./funcfinder --inp internal/finder.go --source go --func FindFunctions --extract

# Call graph
./callgraph --dir . -l go --reverse --func ProcessDirectory

# Large project: split into shards
./funcfinder --dir . --all --json --split        # creates .codemap/
cat .codemap/manifest.json                        # 2KB overview
./funcfinder --dir . --all --json --split --inc   # incremental update

cmd/            CLI entrypoints (thin wrappers)
internal/       Parser engine: finders, sanitizer, formatter, shard logic
languages.json  15 language patterns (embedded)

Parser uses a state-machine sanitizer (not regex) to correctly handle Go raw strings, Python docstrings, C# verbatim literals, nested comments — at 763K lines/sec.

This project uses the DOX framework: a hierarchy of AGENTS.md files that gives AI agents precise, token-efficient context without loading the full repository.

AGENTS.md               ← root: tools overview, workflows, DOX rules
├── cmd/AGENTS.md       ← CLI entrypoints, flag conventions
├── internal/AGENTS.md  ← parser API, how to add languages
├── docs/AGENTS.md      ← documentation rules
├── examples/AGENTS.md  ← example scripts
├── skills/AGENTS.md    ← Claude Code skill definition
├── test_examples/AGENTS.md  ← test fixture rules
└── test_files/AGENTS.md     ← edge-case sanitizer fixtures

Before editing any file, read the chain from root to the target directory:

AGENTS.md → <subdirectory>/AGENTS.md

After any meaningful change, update the nearest AGENTS.md that owns the changed path. Keep the Child DOX Index in each file accurate.

When a folder gains its own stable purpose, contracts, or workflow — create <folder>/AGENTS.md with sections: Purpose · Ownership · Local Contracts · Work Guidance · Verification · Child DOX Index. Then add it to the parent's index.

• AGENTS.md — agent quick reference + DOX framework
• docs/CI_CD.md — CI/CD pipeline
• docs/WINDOWS.md — Windows build guide
• CHANGELOG.md — version history

MIT — see LICENSE