Cartomap
N 48°08.42′ · E 011°34.10′

Open Source · MIT-Lizenz

Eine lebende Karte deiner Codebase.

Cartomap führt eine stets aktuelle, git-versionierte Karte deines Projekts — Routen, Datenmodelle, Hubs, Abhängigkeiten — damit deine KI das Terrain kennt, statt zu raten und Tokens zu verbrennen.

Repo kartieren Auf npm ansehen ↗
~2–4k Token-Karte statt 100k+ Roh-Dateien 0 Abhängigkeiten Node ≥18
~/my-app — survey
$ 
✓ detected   Next.js · TypeScript · Prisma
✓ charted    32 files · 8 routes · 4 models
✓ wrote      .cartomap/ARCHITECTURE.md  (41 ms)
✓ hooked     pre-commit → map stays current
# Deine KI liest jetzt zuerst das Terrain.
48°N

Das Problem

Große Codebases lassen KI-Assistenten raten.

Sie halluzinieren APIs und übersehen übergreifende Zusammenhänge, weil sie immer nur ein paar Dateien sehen. Cartomap gibt ihnen — und neuen Teammitgliedern — das ganze Terrain in wenigen tausend Tokens.

Eine Quelle der Wahrheit

Routen, Modelle, Hubs und verwaiste Module in einer lesbaren Karte — die Vogelperspektive, die deine KI nie hatte.

Wird nie veraltet

Ein Pre-Commit-Hook vermisst die Karte bei jedem Commit neu und staged sie. Immer aktuell — und blockiert nie deinen Commit.

Passt sich deinem Stack an

Erkennt Sprache, Framework, Quell-Roots und Pfad-Aliase automatisch — und wählt den passenden Analyzer für dein Projekt.

≈0k
Tokens pro Karte
0k+
Tokens an Dateien gespart
0+
Sprachen kartiert
0 ms
um 32 Dateien zu vermessen
ROUTE

Schnellstart

Zwei Wege hinein — beide erstklassig.

Starte am ersten Tag und das Gedächtnis wächst organisch mit deinem Projekt. Oder setze es auf ein bestehendes Repo — es erfasst das aktuelle Terrain sofort.

Neues Projekt · perfekt ab Tag eins

Greenfield

Ordner + Git + Cartomap anlegen, dann normal entwickeln. Die Karte wächst mit jedem Commit.

$cartomap new my-app
Bestehendes Projekt · sofortige Momentaufnahme

Bestehendes Repo

Erkennt deinen Stack & deine Pfade und vermisst beim ersten Lauf die komplette Karte.

$cartomap init
Global installieren
$npm i -g cartomap

…oder ohne Installation ausführen — npx cartomap init

KARTENDETAIL

Was du bekommst

Ein Ordner, den deine KI zuerst liest.

.cartomap/
.cartomap/
├─ ARCHITECTURE.md   the map (human-readable)
├─ graph.json        machine-readable graph
└─ memory/
   ├─ INDEX.md       decisions & project knowledge
   └─ decisions.md

# plus a "Project map" block added to your
# CLAUDE.md / AGENTS.md → "read the map first"
ARCHITECTURE.md
# 🗺️  my-app — Project Map

Stack   Next.js · TypeScript · Prisma
Sync    ✓ up to date (main)

## Routes            8 pages · 5 API
/                       app/page.tsx
/blog/:slug             app/blog/[slug]/page.tsx
/api/users  GET POST   app/api/users/route.ts

## Data models       4
User    → 12 files
Post    →  7 files

## Hubs (most imported)
lib/db.ts          ← 18
lib/auth.ts        ← 11

## Orphaned modules  2
lib/legacy/format.ts

Die Karte ist standardmäßig englisch (echte CLI-Ausgabe) — mit "lang":"de" gibt das Tool auch deutsch aus.

PEILUNGEN

Wie es sich deinem Projekt anpasst

Zwei Vermessungstiefen. Keine Konfiguration nötig.

Tiefes Wasser · volle Peilung

TypeScript / JavaScript

Echte TS-Compiler-Analyse — aufgelöste Imports & Exports, Client-/Server-Komponenten, ORM-Modelle und Routen:

  • Next.js App- und Pages-Router
  • NestJS-Controller, Express / Fastify / Koa
  • Prisma- & Drizzle-Modelle
  • tsconfig- / jsconfig-Pfad-Aliase
Flachwasser · strukturelle Vermessung

Alles andere

Ein Datei-Graph plus Import-Heuristiken und ein Doku-Scan — nie ein Absturz, immer eine nützliche Karte:

  • Python, Go, Rust, PHP, Ruby
  • Java / Kotlin, C / C++, C#
  • Sinnvolle Defaults bei leeren oder unbekannten Stacks

Konfigurierbar über cartomap.config.json — Roots, Aliase, beobachtete „kritische" Pfade, Ausgabeordner. Standard Englisch; mit "lang":"de" auf Deutsch.

PFLEGE

Auto-Update

Es vermisst sich selbst neu.

Bei jedem Commit

Ein Pre-Commit-Hook baut die Karte neu und staged sie — sie veraltet nie und blockiert nie deinen Commit.

Husky-freundlich

Nutzt du schon Husky, lefthook oder einen eigenen Hook? Cartomap klinkt sich in dein bestehendes pre-commit ein, statt es zu ersetzen.

Team-bereit

Der Hook ist im Repo eingecheckt. Teammitglieder führen einmal pro Checkout cartomap install-hook aus.

PLUGIN

Claude-Code-Plugin

Ein Befehl und deine KI liest zuerst die Karte.

Cartomap bringt ein Claude-Code-Plugin mit — zwei Slash-Befehle plus ein Skill, der jede KI-Session in einem Cartomap-Projekt zuerst die Karte lesen lässt.

Claude Code
/plugin marketplace add Thepikde/cartomap
/plugin install cartomap@cartomap

# then, inside any project:
/cartomap:init      set up the map
/cartomap:update    re-survey it
✦ DU BIST HIER ✦

Gib deiner KI eine Karte.

Kostenlos, Open Source, null Laufzeit-Abhängigkeiten.

npm i -g cartomap Auf GitHub favorisieren ↗