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 ranEvery 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/repoNext: 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.