Local Repository

Inspect a repository on your local filesystem.

Basic Usage

gitinspect inspect /path/to/repo

Current Directory

gitinspect inspect .

With Comment Stripping

Remove comments and blank lines to save tokens:

gitinspect inspect --strip .

Filter by File Type

Only include Go files:

gitinspect inspect --include "**/*.go" .

Exclude Directories

Skip vendor and test directories:

gitinspect inspect --exclude "**/vendor/*" --exclude "**/*_test.go" .

Limit Token Budget

Get a quick overview with a small budget:

gitinspect inspect --max-tokens 2000 --format text .

Combine Options

Full example combining multiple options:

gitinspect inspect \
  --format text \
  --max-tokens 8000 \
  --max-files 20 \
  --include "**/*.go" \
  --exclude "**/vendor/*" \
  --exclude "**/*_test.go" \
  --strip \
  .

.gitignore Support

gitinspect automatically respects .gitignore files when reading local repositories. Files matching patterns in .gitignore are excluded from the snapshot.

Output to File

gitinspect inspect --quiet --format json . > snapshot.json