How pralhadyadawad/avvarre works
Avvarre is a local-first coding assistant that combines style analysis, workspace and PR reviews, dependency-impact analysis, and persistent memory behind an MCP server and IDE integrations. The main review flow runs from an IDE or CLI request through the server to file/workspace scanning, language rules, scoring, and optional AI analysis. Separate branches cover graph-based impact, memory, setup and skill detection, and IDE lifecycle hooks. Several subsystem links are documented in the README or SOURCE INDEX; unsampled internals are not inferred beyond those references.
Main entry points: server.ts MCP server · engine.ts Analysis engine · index.ts CLI entry · scanner.ts Workspace scanner
Components 21
Entry and review
- CLI entry
src/index.ts - MCP server
src/server.ts - Workspace scanner
src/workspace/scanner.ts - PR scanner
src/workspace/pr_scanner.ts
Code analysis
- Analysis engine
src/analyzer/engine.ts - Language rules
src/analyzer/rules - Scoring
src/analyzer/scorer.ts - AI analysis
src/ai - AI client factory
src/ai/client.ts
Context and impact
- Dependency graph
src/graph/index.ts - AST graph parser
src/graph/parser.ts - Graph database
src/db/connection.ts - Memory store
src/memory/store.ts - Hybrid memory search
src/memory/search.ts - Memory database
src/db/memory-connection.ts
Setup and skills
- Workspace scaffold
src/ecosystem/scaffold.ts - Stack detection
src/ecosystem/stack_detector.ts - Community skills
src/ecosystem/community_fetcher.ts - Claude setup
src/ecosystem/claude_setup.ts
IDE integrations
- IDE lifecycle hooks
plugins/avvarre/hooks
Other components
- Developer / IDE
Connections 23
- Developer / IDE → CLI entry: runs CLI
README.md - Developer / IDE → MCP server: invokes tools
README.md - CLI entry → MCP server: starts server
src/index.ts - CLI entry → Analysis engine: analyzes file
src/index.ts - MCP server → Workspace scanner: scans workspace
src/server.ts - MCP server → PR scanner: audits changes
README.md - Workspace scanner → Analysis engine: analyzes files
src/workspace/scanner.ts - Workspace scanner → AI client factory: requests AI client
src/workspace/scanner.ts - Analysis engine → Language rules: runs rules
src/analyzer/engine.ts - Analysis engine → Scoring: calculates scores
src/analyzer/engine.ts - AI client factory → AI analysis: selects provider
src/ai/client.ts - MCP server → Dependency graph: queries impact
README.md - Dependency graph → AST graph parser: parses files
src/graph/index.ts - Dependency graph → Graph database: updates metadata
src/graph/index.ts - MCP server → Memory store: exposes memory tools
README.md - Memory store → Memory database: persists memories
src/memory/store.ts - Memory store → Hybrid memory search: supports retrieval
README.md - Hybrid memory search → Memory database: queries records
src/memory/search.ts - MCP server → Workspace scaffold: scaffolds workspace
src/server.ts - MCP server → Claude setup: sets up Claude
src/server.ts - Workspace scaffold → Stack detection: detects stack
src/ecosystem/scaffold.ts - Workspace scaffold → Community skills: fetches rules
src/ecosystem/scaffold.ts - Developer / IDE → IDE lifecycle hooks: triggers lifecycle
README.md