How dzhng/jevgrep works
Jevgrep is a repository-question CLI for coding agents: a user asks about code, and the CLI returns ranked file leads and source excerpts. The core workflow filters and reads repository files, evaluates relevance through a selected provider, then selects and formats evidence for stdout. Separate commands configure credentials, install the agent skill, count eligible files, verify provider access, and clear the evaluation cache. Edges follow the README and supplied source/index references; unsampled implementation details are not assumed.
Main entry points: index.ts Command dispatch · retrieve.ts Search orchestration · evaluator.ts Relevance evaluator · auth.ts Provider authentication
Components 26
CLI and setup
- Command dispatch
apps/cli/src/index.ts - Argument parsing
apps/cli/src/args.ts - Provider authentication
apps/cli/src/auth.ts - Skill installation
apps/cli/src/skill.ts - Result rendering
apps/cli/src/render.ts
Repository retrieval
- File inventory
packages/core/src/inventory.ts - Search orchestration
packages/core/src/retrieve.ts - Filtered filesystem
packages/core/src/filesystem.ts - Source inspection
packages/core/src/source.ts - Evidence selection
packages/core/src/selection.ts - Call context
packages/core/src/call-context.ts - Repository guidance lookup
packages/core/src/repository-context.ts
Relevance and parsing
- Relevance evaluator
packages/core/src/evaluator.ts - Evaluation requests
packages/core/src/requests.ts - Provider adapters
packages/core/src/providers.ts - Rate budget
packages/core/src/rate-budget.ts - Language parser
packages/core/src/parser.ts - Parser helpers
packages/core/src/parser-helpers.mjs - Declaration parsing
packages/core/src/parser-declarations.mjs - Preview parsing
packages/core/src/parser-preview.mjs - Parser worker
packages/core/src/parser-worker.mjs
Local state
- Evaluation cache
packages/core/src/cache.ts - Config and cache paths
packages/core/src/storage.ts
Other components
- Developer or agent
- Jev-compatible provider
- Skills installer
Connections 29
- Developer or agent → Command dispatch: runs command
README.md - Command dispatch → Argument parsing: parses arguments
apps/cli/src/index.ts - Command dispatch → Provider authentication: starts auth
apps/cli/src/index.ts - Command dispatch → Skill installation: installs skill
apps/cli/src/index.ts - Command dispatch → File inventory: counts files
apps/cli/src/index.ts - Command dispatch → Search orchestration: runs search
apps/cli/src/index.ts - Command dispatch → Relevance evaluator: checks provider
apps/cli/src/index.ts - Command dispatch → Evaluation cache: clears cache
apps/cli/src/index.ts - Command dispatch → Result rendering: renders results
apps/cli/src/index.ts - Provider authentication → Config and cache paths: stores credentials
apps/cli/src/auth.ts - Provider authentication → Provider adapters: validates provider
apps/cli/src/auth.ts - Skill installation → Skills installer: delegates install
README.md - Search orchestration → Filtered filesystem: creates reader
packages/core/src/retrieve.ts - Search orchestration → Source inspection: inspects source
packages/core/src/retrieve.ts - Search orchestration → Evidence selection: selects evidence
packages/core/src/retrieve.ts - Search orchestration → Call context: adds call context
packages/core/src/retrieve.ts - Search orchestration → Repository guidance lookup: looks up guidance
packages/core/src/retrieve.ts - Search orchestration → Relevance evaluator: scores relevance
packages/core/src/retrieve.ts - Search orchestration → Evaluation requests: builds requests
packages/core/src/retrieve.ts - File inventory → Filtered filesystem: enumerates files
README.md - Filtered filesystem → Config and cache paths: protects local paths
packages/core/src/filesystem.ts - Relevance evaluator → Provider adapters: uses provider
packages/core/src/evaluator.ts - Relevance evaluator → Evaluation cache: reads and writes
packages/core/src/evaluator.ts - Relevance evaluator → Rate budget: controls requests
packages/core/src/evaluator.ts - Relevance evaluator → Jev-compatible provider: sends evaluations
README.md - Source inspection → Language parser: parses declarations
- Parser worker → Parser helpers: runs helpers
packages/core/src/parser-worker.mjs - Parser helpers → Declaration parsing: parses declarations
packages/core/src/parser-helpers.mjs - Parser helpers → Preview parsing: builds previews
packages/core/src/parser-helpers.mjs