Metadata-Version: 2.4
Name: coderecon
Version: 0.1.5
Summary: Engineering-first repository reconnaissance and architectural auditing.
Project-URL: Homepage, https://github.com/mvrkarthik07/coderecon
Project-URL: Documentation, https://github.com/mvrkarthik07/coderecon/blob/main/ARCHITECTURE.md
Project-URL: Youtube Demo, https://youtu.be/84yY41UJoqQ
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp
Requires-Dist: fastmcp
Requires-Dist: click
Requires-Dist: ollama
Requires-Dist: requests


# 🔍 CodeRecon

![CodeRecon Logo](https://raw.githubusercontent.com/mvrkarthik07/coderecon/main/assets/coderecon_logo.png)


**Engineering-first repository reconnaissance and architectural auditing.**

CodeRecon is a pragmatic CLI tool designed to bridge the gap between documentation and reality. It performs deep static analysis of codebases to identify functional mapping, architectural risks, and implementation gaps using local intelligence.

---

**[Architecture Guide](./ARCHITECTURE.md)** – Deep dive into the system design and AST parsing logic.



**[CodeRecon Demo](https://www.youtube.com/watch?v=84yY41UJoqQ)** - *Click to watch the engineering-first reconnaissance workflow in action.*

## 🚀 Installation

### 1. From PyPI
Install the core tool directly via pip:
```bash
pip install coderecon
```
### 2. Local LLM Setup
CodeRecon requires Ollama for its reasoning capabilities.

Download Ollama from ollama.com.

Pull the required model:

```Bash
ollama pull llama3
```
### 🛠️ Usage
Quick Start
Analyze your current directory and get a structural breakdown:

```Bash
coderecon explain .
```
Architectural Mapping
Generate a topology map to see functional roles and risk density:

```Bash
coderecon topology .
```
### Formal Audit
Generate a persistent RECON_REPORT.md with technical specs and Mermaid diagrams:

```Bash
coderecon report .
```
### Remote Audit
Analyze a GitHub repository without cloning it manually:

```Bash
coderecon explain [https://github.com/user/project](https://github.com/user/project)
```
### Help Menu
Gives an entire menu of the available commands and functions and their purposes:

```Bash
coderecon help
```

### 🏗️ Architectural Bucketing
The tool automatically classifies files into functional roles:

Entry Points: System dispatchers and main hooks.

Core: High-logic modules with central dependencies.

Data Layer: Schemas, models, and database logic.

External Integrations: API clients and LLM wrappers.

Utilities: Helper modules and reporting logic.

## 🔌 Architecture & Extensibility (MCP)

CodeRecon is built on the **Model Context Protocol (MCP)**. While primarily a CLI tool, its internal engine functions as an MCP server.

* **Standardized Context**: Uses `fastmcp` to bridge local AST analysis with LLM reasoning.
* **Tool-Agnostic**: Because it follows the MCP standard, CodeRecon’s analysis logic can be plugged into any MCP-compliant host (like Claude Desktop or IDE agents) in the future.
* **Local-First Protocol**: MCP ensures that the communication between the scanner and the LLM happens entirely on your machine.

### 🛡️ Privacy & Philosophy
100% Local: Your code never leaves your machine. Analysis is performed via local AST parsing and local LLM inference.

No-Cap: Prioritizes hard file data over AI "guesses."

Ephemeral: Remote clones are stored in temp directories and aggressively deleted after use.

### Generated by CodeRecon — Local & Private Intelligence.

---
