How issahammoud/codiff works
codiff is an offline structural call-graph diff tool for Python and TypeScript repositories. A user runs the CLI, which ensures a persistent index, builds base and head snapshots, computes and analyzes their graph delta, then renders terminal, Mermaid, or JSON output. Parsing dispatches through language-specific parsers and resolvers. The product also documents GitHub Action and coding-agent/MCP integrations. Relationships below are based on the README and SOURCE INDEX references; unsampled implementation details are represented only where documented.
Main entry points: cli.py CLI · engine.py Diff orchestration · repository.py Repository parser · indexer.py Indexing
Components 28
Entry points
- CLI
codiff/cli.py - MCP server
codiff/mcp_server.py - Agent setup
codiff/setup.py
Index and snapshots
- Indexing
codiff/diff/indexer.py - Snapshots
codiff/diff/snapshot.py - Index operations
codiff/db/operations.py - SQLite engine
codiff/db/engine.py - Database models
codiff/db/models.py - Git utilities
codiff/utils/git.py - File utilities
codiff/utils/files.py
Language analysis
- Repository parser
codiff/languages/repository.py - Parser framework
codiff/languages/parser.py - Python parser
codiff/languages/python/parser.py - Python resolver
codiff/languages/python/resolver.py - TypeScript parser
codiff/languages/typescript/parser.py - TypeScript resolver
codiff/languages/typescript/resolver.py - Shared resolver
codiff/languages/resolver.py - Parse structures
codiff/schema/parsing.py
Graph diff
- Diff orchestration
codiff/diff/engine.py - Graph snapshots and deltas
codiff/schema/diff.py - Snapshot differ
codiff/diff/differ.py - Change analysis
codiff/diff/analysis.py
Integrations and output
- JSON export
codiff/export/json.py - Mermaid export
codiff/export/mermaid.py - Terminal export
codiff/export/terminal.py
Other components
- Developer
- GitHub Action
- Coding agent
Connections 37
- Developer → CLI: runs
README.md - GitHub Action → CLI: invokes diff
README.md - Coding agent → MCP server: requests diffs
README.md - CLI → Diff orchestration: computes diff
codiff/cli.py - CLI → Indexing: indexes repository
codiff/cli.py - CLI → Agent setup: configures agent
codiff/cli.py - MCP server → Diff orchestration: computes diff
codiff/mcp_server.py - Indexing → Snapshots: builds snapshots
codiff/diff/indexer.py - Indexing → Index operations: updates index
codiff/diff/indexer.py - Indexing → Git utilities: checks refs
codiff/diff/indexer.py - Snapshots → Repository parser: parses repository
codiff/diff/snapshot.py - Snapshots → Index operations: loads snapshot
codiff/diff/snapshot.py - Index operations → SQLite engine: creates sessions
codiff/db/operations.py - SQLite engine → Database models: creates tables
codiff/db/engine.py - Repository parser → Parser framework: dispatches parsing
codiff/languages/repository.py - Repository parser → Python parser: dispatches Python
codiff/languages/repository.py - Repository parser → TypeScript parser: dispatches TypeScript
codiff/languages/repository.py - Repository parser → Python resolver: resolves calls
codiff/languages/repository.py - Repository parser → TypeScript resolver: resolves calls
codiff/languages/repository.py - Parser framework → Parse structures: emits chunks
codiff/languages/parser.py - Python parser → Parse structures: emits chunks
codiff/languages/python/parser.py - TypeScript parser → Parse structures: emits chunks
codiff/languages/typescript/parser.py - Python resolver → Shared resolver: uses base resolver
codiff/languages/python/resolver.py - TypeScript resolver → Shared resolver: uses base resolver
codiff/languages/typescript/resolver.py - Diff orchestration → Indexing: ensures indexed
codiff/diff/engine.py - Diff orchestration → Snapshots: builds snapshots
codiff/diff/engine.py - Diff orchestration → Snapshot differ: compares snapshots
codiff/diff/engine.py - Diff orchestration → Change analysis: analyzes delta
codiff/diff/engine.py - Diff orchestration → File utilities: filters tests
codiff/diff/engine.py - Snapshot differ → Graph snapshots and deltas: produces graph delta
codiff/diff/differ.py - Change analysis → Graph snapshots and deltas: consumes graph delta
codiff/diff/analysis.py - CLI → JSON export: exports JSON
codiff/cli.py - CLI → Mermaid export: exports Mermaid
- CLI → Terminal export: renders terminal
- JSON export → Graph snapshots and deltas: serializes results
codiff/export/json.py - Mermaid export → Graph snapshots and deltas: renders results
codiff/export/mermaid.py - Terminal export → Graph snapshots and deltas: renders results
codiff/export/terminal.py