erensh27

erensh27 / CodeMappr

Public

Instantly understand any codebase. One command, zero API keys, works fully offline. Auto-detects 20+ project types, maps architecture, and exports rich Terminal, Markdown & HTML reports.

pypi.orgprojectcodemappr cli code-analysis codebase developer-tools documentation
11
1
85% credibility
Found May 21, 2026 at 11 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

CodeMappr is a command-line tool that scans any folder of code and generates instant visual reports showing what kind of project it is, what programming languages it uses, and how the files are organized. It works completely offline, produces three different report formats (terminal dashboard, Markdown, and HTML), and can identify over 20 different types of projects using pattern recognition without calling any external services.

How It Works

1
💡 You discover CodeMappr

You hear about a tool that can instantly explain any codebase, even ones you've never seen before.

2
📦 You install it in seconds

With one simple command, the tool is ready on your computer. No accounts, no setup needed.

3
🔍 You scan any project folder

You point it at any folder on your computer and watch it explore the structure automatically.

4
🎨 You see a beautiful dashboard

A colorful display shows you what kind of project it is, what languages it uses, and how it's organized.

5
You choose how to save it
🌐
Save as webpage

Get a self-contained HTML file you can open in any browser

📝
Save as text

Get a Markdown file perfect for documentation

🖥️
Keep on screen

View the report directly in your terminal

✅ You understand the project instantly

In seconds, you grasp the architecture and key files of any codebase without reading through hundreds of files.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 11 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is CodeMappr?

CodeMappr is a Python CLI tool that scans any codebase and spits out an instant architecture overview. Run one command, get a project profile showing what kind of app it is, what languages and frameworks it uses, and how it's organized. It works completely offline with no API keys required. You can output reports as a terminal dashboard, Markdown file, or interactive dark-themed HTML, making it useful whether you're live-ssh'd into a server or documenting a project for a pull request.

Why is it gaining traction?

The offline-first approach is the main draw. Most codebase analysis tools require sending your code to some external service, which developers rightfully distrust. CodeMappr uses heuristics instead, detecting over 20 project types from file patterns and manifest presence. The multi-format export is practical for different workflows: scan and view instantly in the terminal, or generate a CODEMAPPR.md for documentation. One command handles everything from scan to export, which fits how developers actually work.

Who should use this?

Tech leads onboarding engineers into unfamiliar codebases will find this useful for quick orientation. Developers joining a new team can run it on their first day to understand the project shape without reading every README. It's also handy for repo maintenance when you need a quick structural overview before refactoring. Consultants or auditors evaluating unknown codebases get a fast read on architecture without setup overhead. If you need dependency graphs or advanced relationship mapping, the current feature set won't cover that yet.

Verdict

The credibility score sits at 0.85%, reflecting a young project with only 11 stars and minimal community adoption. The code is clean, the feature set is coherent, and it delivers exactly what it promises without overreach. At v1.0.0, it has a solid foundation but lacks the battle-testing that comes from broad use. Worth trying for immediate practical needs, but hold off on mission-critical pipelines until the project builds a track record. Watch for the v2.0 file relationship mapping feature as a potential inflection point.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.