get_repository_summary tool

Tool: get_repository_summary

Returns a token-budgeted overview of the repository: languages, the top modules by symbol count, and key symbols. The output is hard-capped so it stays small no matter how large the repository is. Pass a module to drill into one directory on demand.

Arguments Schema

Parameter	Type	Required	Description
repo_path	string	Required	Absolute path to the workspace root.
budget	string	Optional	Output token cap: small (~500), medium (~1500), large (~3000). Default small.
module	string	Optional	Optional module name or directory path to drill into instead of the whole repo.

Tool Input JSONRequest

{
  "repo_path": "/path/to/repo",
  "budget": "small"
}

Tool Response JSONResponse

Files: 100
Symbols: 988
Test Files: 22
Languages: go:99, python:1
Modules:
  retrieval (go) - 26 files, 296 symbols
  treesitter (go) - 12 files, 105 symbols
  +23 more modules (62 files, 587 symbols)
Entry Points: cmd/costwise/main.go

Developer Best Practices

Call this on first connection to learn the repo shape cheaply, without dumping a file tree into context.
Use the module argument to drill into one directory instead of widening the whole summary.