Quick start

Getting started

Installation

Install the platform-specific binary wheel from PyPI as an isolated tool, or into an active virtual environment.

uv tool install urmare
pipx install urmare
pip install urmare

uvx urmare impact --changed

Repository

Select the repository

Run inside the repository, or place the global --rootoption before the command. An explicit root is authoritative.

urmare --root path/to/repository graph

Git-aware commands discover the containing Git repository when--root is omitted.

Impact

Choose a change source

urmare impact src/payments/service.py

urmare impact src/payments/service.py src/payments/models.py

urmare impact --changed

urmare impact --git-diff origin/main

Results

Use the result

urmare tests --affected --changed

urmare tests --affected src/payments/service.py

urmare why src/payments/service.py tests/test_service.py

urmare impact --changed --json

{
  "schema_version": 1,
  "changed": ["src/payments/service.py"],
  "directly_affected": ["src/api/checkout.py"],
  "transitively_affected": [],
  "affected_tests": ["tests/test_service.py"],
  "attributions": [
    {
      "affected": "tests/test_service.py",
      "caused_by": ["src/payments/service.py"]
    }
  ]
}

Reference

Current limitations

• Static import and from … import relationships only.
• File-level modules and test selection; no individual test-function selection.
• No dynamic-import, re-export, symbol, call, type, fixture, runtime, or framework graph.
• No dependency-upgrade or external package-index analysis.
• Discovery and in-memory graph allocation run on every command; safe parsed imports and resolution results can be reused.