Repo X-ray

One artifact. Every AI tool understands your repo the same way.

Repo X-ray analyzes a codebase and produces a single, structured architecture artifact (.repox/architecture.json + .repox/architecture.md) that any AI tool can consume — Cursor, Claude Code, Copilot, custom agents, or downstream DevTrust products.

For the full product spec, see ../PRODUCT.md.

v0.0.1 — what works today

  • repox build [PATH] — walks a repo, classifies files by language, identifies likely entry points, emits both architecture.json and architecture.md.
  • repox version — prints the installed version.
  • Honors .gitignore via pathspec.
  • Beautiful terminal output via rich.

Roadmap (matches the master plan)

  • v0.1 — language coverage extends to TS/JS, Python, Go, Rust; basic dependency graph from manifests; convention extraction (naming patterns, error handling).
  • v0.2 — call graph via tree-sitter; module-boundary inference.
  • v0.3 — incremental updates (repox update); MCP server.
  • v0.5 — public release with CI integration (GitHub Action).
  • v1.0 — stable artifact format, language coverage to Java, C#, Ruby.

Install

From the monorepo root:

# uv (recommended) — installs all workspace members
uv sync --all-groups

# pip
pip install -e .

Use

# Analyze the current directory
repox build

# Analyze a specific repo
repox build C:\Users\you\some-repo

# Print version
repox version

Output lands in .repox/architecture.json and .repox/architecture.md at the analyzed repo root.

Layout

code/
├── pyproject.toml
├── README.md
├── src/
│   └── repox/
│       ├── __init__.py
│       ├── __main__.py        Allows `python -m repox`
│       ├── cli.py             Typer-based CLI entry point
│       ├── models.py          Pydantic data models (Architecture, FileInfo, etc.)
│       ├── analyzer.py        Tree walk, language detection, entry-point detection
│       └── output.py          JSON + Markdown writers
└── tests/
    ├── __init__.py
    ├── conftest.py
    └── test_smoke.py

License

Apache-2.0. See LICENSE at the monorepo root.

Project links

Data verified by PyPI on May 9, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Abdullah_Bakir from gravatar.com Abdullah_Bakir

Credits

Author: Abdullah Bakir

GitHub Statistics

Data verified by PyPI on May 9, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.11

Tags

ai codebase-analysis developer-tools mcp repo-analysis

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

devtrust_repox-0.4.0.tar.gz (31.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

devtrust_repox-0.4.0-py3-none-any.whl (28.0 kB view details)

Uploaded Python 3

File details

Details for the file devtrust_repox-0.4.0.tar.gz.

File metadata

  • Download URL: devtrust_repox-0.4.0.tar.gz
  • Upload date:
  • Size: 31.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for devtrust_repox-0.4.0.tar.gz
Algorithm Hash digest
SHA256 667353300e649aa06dad6f729e6bd7644c449d757962eec39085f6dae34c8266
MD5 96ea8a394ade70a3e42ef9fa60ff37db
BLAKE2b-256 1a98e2a0fc1eac31004157d5ec79d2232a1ae1c23d4e338f370c46ffa7a9ac73

See more details on using hashes here.

Provenance

The following attestation bundles were made for devtrust_repox-0.4.0.tar.gz:

Publisher: release.yml on AbdullahBakir97/DevTrust

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file devtrust_repox-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: devtrust_repox-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 28.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for devtrust_repox-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4c77e0447d40388164a52567c3bad70c7a4517b67a760cf60d0e5712dd74bf7d
MD5 5a001a1650e4205fd8e7e9a5f20345a9
BLAKE2b-256 7076ca037233d5871d4a2f6150f86ceba3e52dc2271ce400688cf9668c9d19bb

See more details on using hashes here.

Provenance

The following attestation bundles were made for devtrust_repox-0.4.0-py3-none-any.whl:

Publisher: release.yml on AbdullahBakir97/DevTrust

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page