Skip to main content
Glama
README.md
# RepoMind

An **evidence-linked change-impact graph** for a repository: which files
import which, what is impacted when a file changes, and — stated plainly —
what the graph does **not** know.

[![M8ven Score](https://m8ven.ai/badge/mcp/iceman2050-repo-mind-1qeq71?v=db1c886be5afb46abdc8399736550ce0)](https://m8ven.ai/mcp/iceman2050-repo-mind-1qeq71?s=readme)

Every edge carries its evidence (the import statement and line it came from).
Impact is computed only from those edges. Anything RepoMind cannot resolve —
unparseable files, unresolved imports, dynamic imports, reflection,
cross-language links — is reported under `unknowns` or in the impact note.
**Unknowns are stated as unknown, never filled in with a guess.**

## Install

```bash
pip install -e .
```

## Use

```bash
repo-mind graph path/to/repo --output graph.json
repo-mind impact path/to/repo src/core.py
repo-mind mcp   # minimal MCP stdio interface: repo_graph, repo_impact
```

## Limitations

- Python imports only in v0.1.0; other languages are not graphed.
- Static imports only — dynamic import, plugin loading, and string-based
  dispatch are invisible to this graph and are called out as unknowns.
- Impact means "imports, directly or transitively", not "will break".

Built by Ingenious AI — https://getingeniousai.com