tessri.

Getting started

Install Tessri, run one command in any repository, and build a single-file copy when installing is not an option.

pip install tessri            # or run it once without installing: uvx tessri scan .
tessri scan .                 # markdown report
tessri scan . --format json   # machine-readable
tessri scan . --format html --out report.html   # one page to open or share
tessri why path/to/file.py    # the evidence behind one verdict
tessri graph .                # how modules depend on each other, and the cycles
tessri impact path/to/file.py # what a change can reach, the tests that reach it, who to tell
tessri triage --since main    # the files of a change to look at first, and who can look
tessri check --since main     # what a change did to the structure, with an exit code for CI
tessri brief --since main     # one page to hand the change over: both of the above, from one analysis, with what you ran

Every command takes the repository root as --repo PATH (scan and graph also as their first argument). Without --since, a branch is judged against the default branch: the one the remote declares, else main or master.

No install at all: build a single 300 KB file and drop it into any repository.

mkdir build && cp -r tessri build/       # from a checkout of this repository
python3 -m zipapp build -m tessri.cli:main -o tessri.pyz
python3 tessri.pyz scan /path/to/any/repo

Next: what scan tells you, or mount the agent skill.

Source: docs/guide/getting-started.md, Markdown in the repository; this page is built from it. Edit it on GitHub.