mapifyy-cli 0.1.2

AI coding assistant memory layer & semantic graph generator

Mapify

A semantic codebase mapping engine for AI.

Mapify is a CLI tool that instantly scans your project, parses the Abstract Syntax Trees (ASTs) of your code, and generates a rich Semantic Knowledge Graph. It analyzes how files, classes, and functions are connected to identify the "God Nodes" (the most important files in your architecture), giving you or your AI agents perfect context of how a codebase is wired together.

Supported Languages

Mapify uses lightning-fast tree-sitter and robust regex parsing to support:

• Python
• TypeScript / JavaScript
• Go
• Rust
• Java
• C / C++
• Ruby
• SQL
• Prisma

Installation

Install globally using pip (or pipx for isolated environments):

pip install mapifyy-cli

Usage

Navigate into any codebase directory on your machine and run the Mapify engine

cd your-project-folder
mapify run .

Mapify will discover your files, parse them, and generate a mapify-out/ folder containing your Codebase Blueprint and Semantic Graph, ready to be fed into any LLM or MCP agent

graph TD
    %% Define styles
    classDef inputObj fill:#2d3436,stroke:#74b9ff,stroke-width:2px,color:#fff;
    classDef process fill:#0984e3,stroke:#000,stroke-width:1px,color:#fff;
    classDef output fill:#00b894,stroke:#000,stroke-width:1px,color:#fff;

    %% Nodes
    A[(Target Codebase)]:::inputObj
    
    B[1. Smart File Discovery<br/><i>Ignores .gitignore & .venv</i>]:::process
    C[2. AST Extraction<br/><i>tree-sitter parsing</i>]:::process
    D[3. Graph Construction<br/><i>networkx nodes & edges</i>]:::process
    E[4. PageRank Analysis<br/><i>Calculates structural weight</i>]:::process
    
    F[/Codebase Blueprint JSON/][::output]
    G[/Semantic Graph JSON/][::output]
    H((CLI: God Nodes)):::output

    %% Edges
    A -->|Raw Files| B
    B -->|Filtered Paths| C
    C -->|Classes, Functions, Imports| D
    D -->|Mathematical Model| E
    
    C --> F
    D --> G
    E --> H

Note

ALways use .gitignore for better ananlysis