reposhape
reposhape draws a map of a codebase: every file, the folder it sits in, and which files import which. It reads TypeScript, JavaScript, Vue and Python, runs on your machine, and opens the map in your browser.
The folders · size view of LangChain, 1,766 source files with tests hidden. Each circle is a folder and each dot is a file, sized by its line count. Colours are clusters worked out from the imports.
The folders · imports view: the same repo with the imports that cross from one package to another drawn on top.
Install
You need Python 3.14 on macOS or Linux.
uv tool install reposhape
pipx install reposhape works too.
Quick start
cd path/to/your/repo
reposhape up .
This analyses the repo, starts a small local server and opens the map. The
server keeps running after you close the terminal. reposhape down stops it.
| Command | What it does |
|---|---|
reposhape up . |
Analyse the current repo and open its map |
reposhape up <url> |
Clone a repo, analyse it and open its map |
reposhape up |
Open the page on the repo picker |
reposhape status |
Show whether the server is running, and where |
reposhape down |
Stop the server |
Privacy
Your code is parsed locally with tree-sitter. No LLM and no outside service is involved. The server only listens on 127.0.0.1 and rejects requests from other websites.
More
Docs, source and issues: https://github.com/nabinpkl/reposhape. MIT licensed.
1 maintainer
Metadata
1 maintainer
Release files for reposhape 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| reposhape-0.1.2.tar.gz | 834.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| reposhape-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.7 MB
Release files / reposhape-0.1.2.tar.gz
| Download URL | reposhape-0.1.2.tar.gz |
|---|---|
| Size | 834.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7e997070250ba7902014a46648c31b069cfa71d049e5e96927a322c2ccccaae1
|
|
BLAKE2b-256 checksum How to use checksums |
ff40a4c2a271815b146fb5dab026d7923397f81986a980bed074f6a99069dd26
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.
Transparency logRelease files / reposhape-0.1.2-py3-none-any.whl
| Download URL | reposhape-0.1.2-py3-none-any.whl |
|---|---|
| Size | 840.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
822a9191c405e26f0800326835a2ecd6e0fc2991b5a2057d4ae4ab4bd587012f
|
|
BLAKE2b-256 checksum How to use checksums |
ba475af185611b58c5133a5b246e88e35624dff21b3369505908ab027a736437
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.
Transparency log
