Metadata-Version: 2.5
Name: thrubase
Version: 0.1.0a1
Summary: Climb a codebase: a terrain map of a Python repository and guided reading trails with comprehension checkpoints.
Project-URL: Homepage, https://github.com/regx64/thrubase
Project-URL: Issues, https://github.com/regx64/thrubase/issues
Author: regx64
License-Expression: AGPL-3.0-only
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.10
Requires-Dist: filelock>=3.13
Requires-Dist: httpx>=0.27
Requires-Dist: networkx>=3.2
Requires-Dist: numpy>=1.26
Requires-Dist: pathspec>=0.12
Requires-Dist: rich>=13.7
Requires-Dist: starlette>=0.37
Requires-Dist: tomli-w>=1.0
Requires-Dist: tomli>=2.0; python_version < '3.11'
Requires-Dist: tree-sitter-python>=0.23
Requires-Dist: tree-sitter>=0.25
Requires-Dist: typer>=0.12
Requires-Dist: uvicorn>=0.29
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: hypothesis>=6.100; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Description-Content-Type: text/markdown

# thrubase

Climb a codebase. Thrubase reads a Python repository without running it, draws a terrain
map of its functions by importance (altitude), and walks you along a trail of 12–15
segments from the entry points to the summits, with a short comprehension checkpoint at
the end of each segment. A diff climb does the same for uncommitted changes.

```bash
pipx install thrubase
thrubase map .            # terrain map summary
thrubase climb .          # full climb in the terminal
thrubase climb . --diff   # climb the uncommitted changes
thrubase serve .          # local web UI
```

Code is never executed. Nothing is sent anywhere unless you configure an LLM key for
optional reading guides.

See https://github.com/regx64/thrubase for the VS Code extension and documentation.
