Repoxray: A Retrieval-Augmented Framework for Semantic Analysis and Repository-Level Understanding of Software Codebases

Understanding an unfamiliar software repository is difficult because modern codebases contain interconnected files, modules, dependencies, and configuration artifacts. Traditional keyword-based search provides limited contextual understanding, while directly processing large repositories using Large Language Models (LLMs) introduces context and scalability challenges. This paper presents RepoXray, a retrieval-augmented framework for repository-level software understanding. The system combines file-level LLM analysis, semantic embeddings, vector retrieval, and Map-Reduce-based synthesis to generate repositorylevel architecture and security-oriented reports. It also provides an AI Chat Console that retrieves relevant repository information to answer natural-language queries, along with an interactive File Explorer for inspecting source code and AI-generated file-level analysis. RepoXray was evaluated using 20 public GitHub repositories across four programming languages. It achieved 84.91% architecture fact coverage and 84.75% repository-aware question-answering accuracy. The preliminary combined score was 84.83%. Security performance could not be quantitatively validated because the evaluation dataset contained no positive ground-truth vulnerability instances. These results demonstrate the potential of RepoXray for improving repository understanding while highlighting the need for further evaluation.

Authors

Publication Details

Journal
International Journal of Advanced Research in Science Communication and Technology
Published
2026-11-17
DOI
https://doi.org/10.48175/ijarsct-40821
Primary Topic
Software Engineering Research
Type
article
Field-Weighted Citation Impact
0.00
Controls
|||
ALL TIME
JAN
FEB
MAR
APR
MAY
JUN
JUL
AUG
SEP
OCT
NOV
article

Repoxray: A Retrieval-Augmented Framework for Semantic Analysis and Repository-Level Understanding of Software Codebases

Shehnaz Siddique, Nidhi Pote, Manasi Rugle, Hrishita Gohain
2 links
International Journal of Advanced Research in Science Communication and Technology
Software Engineering Research
article

Repoxray: A Retrieval-Augmented Framework for Semantic Analysis and Repository-Level Understanding of Software Codebases

Shehnaz Siddique, Nidhi Pote, Manasi Rugle, Hrishita Gohain
article en

Abstract

Understanding an unfamiliar software repository is difficult because modern codebases contain interconnected files, modules, dependencies, and configuration artifacts. Traditional keyword-based search provides limited contextual understanding, while directly processing large repositories using Large Language Models (LLMs) introduces context and scalability challenges. This paper presents RepoXray, a retrieval-augmented framework for repository-level software understanding. The system combines file-level LLM analysis, semantic embeddings, vector retrieval, and Map-Reduce-based synthesis to generate repositorylevel architecture and security-oriented reports. It also provides an AI Chat Console that retrieves relevant repository information to answer natural-language queries, along with an interactive File Explorer for inspecting source code and AI-generated file-level analysis. RepoXray was evaluated using 20 public GitHub repositories across four programming languages. It achieved 84.91% architecture fact coverage and 84.75% repository-aware question-answering accuracy. The preliminary combined score was 84.83%. Security performance could not be quantitatively validated because the evaluation dataset contained no positive ground-truth vulnerability instances. These results demonstrate the potential of RepoXray for improving repository understanding while highlighting the need for further evaluation.

International Journal of Advanced Research in Science Communication and Technology
Software Engineering Research
AI Navigator

Ask Laika to Summarize, Analyze, and Connect papers live on the map.

Summarize Papers & Methodologies

Extract key findings, datasets, and comparative methods across publications.

Benchmark Rankings & Visual Analytics

Rank top research institutions, authors, funders, topics, and journals by Field-Weighted Citation Impact (FWCI) and paper volume with instant charts.

Connect Distant Disciplines

Bridge topological clusters on the map to find hidden collaborative intersections.

Laika access coming soon