explaingit

erensh27/codemappr

Analysis updated 2026-06-24

★ 12PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

Local Python CLI that scans a codebase, detects the project type and languages, and prints or exports a terminal, Markdown, or HTML architecture summary.

Mindmap

mindmap
  root((CodeMappr))
    Inputs
      Project folder
      Detection rules
      CLI flags
    Outputs
      Terminal dashboard
      Markdown report
      HTML report
    Use Cases
      Codebase overview
      Onboard new repo
      PR architecture note
    Tech Stack
      Python
      pip
      CLI
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a quick architecture summary of an unfamiliar repo from the terminal

USE CASE 2

Generate a CODEMAPPR.md file for a pull request or repo docs

USE CASE 3

Export a dark-themed HTML overview with a collapsible directory tree

USE CASE 4

Skip cache or temp folders during a scan with --ignore patterns

What is it built with?

PythonpipCLI

How does it compare?

erensh27/codemappraim-uofa/reasonmatcharpecop/kokobook
Stars121212
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/55/53/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Single pip install with no API key or network call needed.

MIT license, do almost anything with the code as long as you keep the copyright notice.

In plain English

CodeMappr is a command-line tool that prints a quick, high-level summary of any codebase it is pointed at. You install it from PyPI with pip install codemappr, then run codemappr scan in a project folder. It walks the directory tree, makes a guess about what kind of project it is, lists the languages used, and produces a short architecture overview. The README's main selling point is that the tool runs entirely on your machine and does not need an API key or an internet connection. Project type detection is rule-based. The README lists over twenty patterns the scanner looks for: a packages or apps folder for monorepos, package.json with React or Next for Next.js.vue files for Vue, angular.json for Angular, manage.py with settings.py and urls.py for Django, FastAPI or Flask entry points, pyproject.toml or setup.py for Python libraries, Cargo.toml for Rust, go.mod for Go, Maven pom.xml or Gradle build files for Java, AndroidManifest.xml for Android, pubspec.yaml for Flutter, Gemfile and routes.rb for Rails, composer.json with artisan for Laravel, Dockerfile or docker-compose.yml.ipynb notebooks with pandas for data science, a root index.html for static sites, and generic Python or JS fallbacks. There are three output modes. The default is an in-terminal dashboard with colored panels for the project profile, the architecture summary, and a styled directory tree. Passing --format md writes a portable CODEMAPPR.md file you can drop into a pull request or repository docs. Passing --format html writes a single CODEMAPPR.html with a dark theme and collapsible directory trees, meant for browsing larger codebases. Passing --format all writes every format in one run. Other CLI options in the quick start include a path argument to scan a specific directory, --depth to cap how far the tree walk goes, and --ignore with a comma-separated list of patterns to skip such as .cache or temp. The README does not describe the heuristics beyond the detection-signal table. The roadmap lists three milestones. Version 1.0.0 is already done and covers the core scanning, detection, terminal output, and exports. Version 2.0.0 is planned to add a file relationship map, and version 3.0.0 is planned to add a structural diff or changelog feature. Contributions are accepted through the usual fork, branch, run pytest, and pull request flow, and new features are expected to come with tests and doc updates. The license is MIT.

Copy-paste prompts

Prompt 1
Walk me through installing codemappr from PyPI and running codemappr scan on a Django project root.
Prompt 2
Show me a one-liner to export CODEMAPPR.md and CODEMAPPR.html for a monorepo with --format all and --depth 4.
Prompt 3
Explain the detection rules in CodeMappr and what files make it tag a project as Next.js versus a generic Node app.
Prompt 4
Help me add a comma-separated --ignore list to skip .cache, node_modules, and build folders during a scan.
Prompt 5
Sketch what version 2.0.0 of CodeMappr could output for a file relationship map and how I might prototype it as a contributor.

Frequently asked questions

What is codemappr?

Local Python CLI that scans a codebase, detects the project type and languages, and prints or exports a terminal, Markdown, or HTML architecture summary.

What language is codemappr written in?

Mainly Python. The stack also includes Python, pip, CLI.

What license does codemappr use?

MIT license, do almost anything with the code as long as you keep the copyright notice.

How hard is codemappr to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is codemappr for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos