Installation

If the calldiff command is unavailable, install the latest version globally:

npm install -g calldiff@latest

Presenting output

Whenever showing calldiff output to the user, wrap it in a fenced diff code block so additions and removals receive colored syntax highlighting:

```diff
<calldiff output>
```

calldiff diff

Diff call stacks between two git trees

Arguments

Name	Type	Required	Description
from	string	no	Before ref (default: HEAD)
to	string	no	After ref (default: working tree)
paths	array	no	Limit to these path prefixes

Options

Flag	Type	Default	Description
--entry	unknown
--maxDepth	number	12	Max call-tree depth
--from	string		Left / "before" tree
--to	string		Right / "after" tree

Examples

# HEAD vs working tree
calldiff diff

# One ref vs working tree
calldiff diff main

# Two commits / branches
calldiff diff abc123 def456

# Force entrypoints
calldiff diff main feature --entry createAgentSession

Semantics match git diff: no refs -> HEAD vs worktree; one ref -> that vs worktree; two refs -> compare those trees.

---

calldiff reach

Find all call paths from an entrypoint to a target symbol

Arguments

Name	Type	Required	Description
ref	string	no	Git ref (default: working tree)
paths	array	no	Limit to these path prefixes

Options

Flag	Type	Default	Description
--entry	unknown		Entrypoint(s): functionName or ClassName.method
--to	string		Target symbol to reach (functionName or ClassName.method)
--maxDepth	number	12	Max call-tree depth

Examples

# Paths in the working tree
calldiff reach --entry runCheckout --to sendEmail

# Paths at a commit, limited to a directory
calldiff reach HEAD examples/checkout --entry runCheckout --to sendEmail

---

calldiff tree

View a call tree (no diff) for one or more entrypoints

Arguments

Name	Type	Required	Description
ref	string	no	Git ref (default: working tree)
paths	array	no	Limit to these path prefixes

Options

Flag	Type	Default	Description
--entry	unknown		Entrypoint(s): functionName or ClassName.method
--maxDepth	number	12	Max call-tree depth

Examples

# Tree from working tree
calldiff tree --entry createAgentSession

# Tree from a commit
calldiff tree HEAD --entry PiService.createAgentSession