Threadline

Explore Python workflows, from an endpoint or method to the original source.

Get started · Documentation · GitHub · Report a bug

Threadline opens your Python repository in a local browser. Choose an endpoint, command, or module and method to follow its calls across files. See branches, inputs, return values, and the code behind each step together.

It reads source without importing or running the project being reviewed. That project's dependencies do not need to be installed.

Install and open a repository

Requires Python 3.12 or later. In your Python environment:

python -m pip install --pre threadline-review
threadline review /path/to/your/python-project

Your browser opens the review automatically. If it does not, open the local address printed in the terminal. For virtual-environment setup, see the installation guide.

Choose where to start

Search is available across all three pages. Selecting a method opens its workflow and original source; nothing is selected automatically.

Follow calls in the workflow, expand a branch for its local logic, or select a step to highlight its source. Calls into other modules retain their source evidence. Large workflows and branch bodies load progressively.

Review a change

Compare a working tree with a Git baseline:

threadline review /path/to/your/python-project --base HEAD

Open Changes to select a changed method or compare its before/after source. Current callers, historical callers, and possible impact are shown separately.

For source roots, exclusions, and JSON output, see the usage guide.

Understand the limits

Threadline uses static analysis. Calls are labeled supported, possible, external, or unknown according to the source evidence. Dynamic dispatch can remain unresolved; the view does not establish what happened at runtime. Open Coverage to inspect parse failures and unmodeled syntax.

This is a beta. Linux and macOS are tested with Python 3.12–3.14; Windows is experimental. Human reviewer sessions remain pending before a stable release.

• Capabilities and limits
• Validation and platform coverage
• Keyboard access and accessibility
• Changelog

Contribute

See the contributor guide for development and testing, and the publishing guide for releases.

MIT License · Security policy