Get a language and size breakdown for a local repository.

Args: path: Filesystem path to the repo root (default: current directory).

Returns: Dict with total_files, total_lines, and a per-extension breakdown (files + lines), sorted by line count descending.

Scan a repo for TODO / FIXME / HACK / XXX comments.

Args: path: Filesystem path to the repo root. max_results: Cap on how many matches to return (default 100).

Returns: List of {file, line_number, tag, text} dicts, one per match found.

Summarize the most recent git commits in a repo: author, date, message, and how many lines were added/removed.

Args: path: Filesystem path to the repo root (must be a git repo). count: How many recent commits to include (default 10).

Returns: Dict with a list of commits, or an error if this isn't a git repo.

Flag source files that are unusually large — often a signal they're due for a refactor or split.

Args: path: Filesystem path to the repo root. threshold_lines: Minimum line count to be flagged (default 300). top_n: Max number of files to return, largest first (default 10).

Returns: List of {file, lines} dicts, sorted largest first.

Give a repository an overall health score with supporting evidence.

Checks for a README, a LICENSE, a test suite, and Git version control, plus TODO density and oversized files, then rolls it all into a single 0-100 score with concrete recommendations.

Args: path: Filesystem path to the repo root. large_file_threshold: Line count above which a file counts as "large".

Returns: Dict with score, component checks, counts, largest_files, and a list of recommendations for the lowest-scoring areas.

Detect a project's technology stack from its manifest and config files.

Looks for common manifests (pyproject.toml, requirements.txt, package.json, Dockerfile, docker-compose.yml, GitHub Actions workflows, Cargo.toml, go.mod, composer.json, build.gradle, and more), and inspects package.json / requirements.txt contents for known frameworks and databases.

Args: path: Filesystem path to the repo root.

Returns: Dict with sorted lists for languages, frameworks, databases, package_managers, ci_cd, and deployment, plus the manifest files that were found.