This release is a pre-release and may not be stable for production use.
Repox
The repo index that makes coding agents smart.
Repox scans any codebase and builds a persistent intelligence profile - 13 extraction dimensions covering everything from tech stack and architecture to auth flows, state machines, and security posture. Instead of starting from zero, your coding agent gets institutional knowledge so generated code fits the project like a senior wrote it.
Installation
With uv (recommended):
uv tool install repoxai
With pip:
pip install repoxai
Requires Python 3.12+.
Quick Start
# Set up LLM (needed for scan + context)
export ANTHROPIC_API_KEY=sk-... # or OPENAI_API_KEY or GEMINI_API_KEY
# Scan a repo
repox scan /path/to/repo
# View full profile (no LLM needed)
repox show
# Get a task-specific advisory brief
repox context "Fix the login bug in auth.py" --target-files src/auth.py
What It Extracts
| # | Dimension | What it captures |
|---|---|---|
| 1 | Tech Stack | Language, framework, package manager, test runner, dependencies |
| 2 | Architecture | Pattern detection (layered, DDD, MVC, hexagonal, flat, etc.) |
| 3 | Symbols | Full AST symbol graph - functions, classes, methods, constants |
| 4 | Dependencies | Import graph, call graph, PageRank-based file importance |
| 5 | API Surface | HTTP endpoints, MCP tools, Celery tasks, WebSocket events |
| 6 | Data Models | ORM entities, Pydantic models, Prisma schemas, field definitions |
| 7 | Design Patterns | Factory, Builder, Observer, Repository, Middleware, Strategy |
| 8 | Infrastructure | Docker services, env vars, deployment targets, external integrations |
| 9 | Conventions | Naming, error handling, async patterns, import style, type hints |
| 10 | Test Patterns | Framework, file naming, fixtures, mocking, assertion style |
| 11 | Hotspots | Churn-complexity analysis, temporal coupling, knowledge islands |
| 12 | Custom Rules | Team conventions from CLAUDE.md, .cursorrules, AGENTS.md, etc. |
| 13 | Behavioral | Auth flows, state machines, middleware chains, background jobs, API contracts |
Plus LLM Interpretation (architecture insights, convention synthesis) and Security Posture (auth defaults, input validation, SQL safety, CORS, secret management).
Agent Integration
Add to your agent's rules file (CLAUDE.md, .cursorrules, AGENTS.md):
Before starting any task, run `repox show` to understand the codebase structure, conventions, and patterns. Use this context to write code that fits the project.
Links
- Full documentation: https://github.com/kmandana/RepoX
- Issues: https://github.com/kmandana/RepoX/issues
- Releases: https://github.com/kmandana/RepoX/releases
1 maintainer
Metadata
1 maintainer
Release files for repoxai 0.1.0a2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| repoxai-0.1.0a2.tar.gz | 95.3 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| repoxai-0.1.0a2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 177.5 kB
Release files / repoxai-0.1.0a2.tar.gz
| Download URL | repoxai-0.1.0a2.tar.gz |
|---|---|
| Size | 95.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
58a8ea32fd7cd4fd26aac01ab441b0d095367c8376c0b1d23e5310213d945544
|
|
BLAKE2b-256 checksum How to use checksums |
5dc8a7b77d5a5a0eb931d646e45de55abc603c16549b111af4200f610094514b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Apr 7, 2026.
Transparency logRelease files / repoxai-0.1.0a2-py3-none-any.whl
| Download URL | repoxai-0.1.0a2-py3-none-any.whl |
|---|---|
| Size | 82.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
12beab6f79807d536cfc80ccbb7cc32fde4e7379922290dccdd636848c2281fe
|
|
BLAKE2b-256 checksum How to use checksums |
ed129ec9edca799f4c5e0cc8152b8d44afc24f68b49abbe1999e28c9bbeb0114
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Apr 7, 2026.
Transparency logSecurity for repoxai 0.1.0a2
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for repoxai-0.1.0a2.tar.gz
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 Apr 7, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
