royals7272/stacklit

Was macht stacklit?

Indiziere Codebasen für KI-Agenten mit einem einzigen Befehl. Erstelle eine lokale Karte deines Repositorys ohne Serveranforderungen oder Einrichtung.

Übersicht

stacklit ist ein Werkzeug, das es dir ermöglicht, die Struktur deines Code-Repositorys in einem Format zu erfassen, das KI-Agenten (wie Claude Code, Cursor, Codex) sofort nutzen können. Mit nur einem Befehl erzeugt es eine Datei (standardmäßig stack.md), die eine baumartige Darstellung deines Projekts mit Pfaden, Importen und Schlüsselkontext enthält.

Funktionen

• Serverlos: Keine laufenden Dienste oder Cloud-Abhängigkeiten – alles geschieht lokal.
• Keine Einrichtung: Keine Installation von Paketen, keine Konfigurationsdateien oder API-Keys erforderlich.
• Ein Befehl: Einfach npx stacklit ausführen, und die Karte wird generiert.
• Sicher: Da die Indizierung lokal bleibt, verlassen keine sensiblen Daten dein System.

Verwendung

Führe den folgenden Befehl im Stammverzeichnis deines Projekts aus:

npx stacklit

Standardmäßig erstellt dies eine Datei namens stack.md im aktuellen Verzeichnis. Du kannst den Ausgabepfad mit einem Argument anpassen:

npx stacklit pfad/zu/ausgabe.md

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex (GitHub Copilot)
• Andere KI-Agenten, die strukturierte Markdown-Eingaben akzeptieren

Funktionsweise

Das Skript durchläuft dein Repository rekursiv (unter Beachtung von .gitignore-Regeln), sammelt Dateipfade, extrahiert Importanweisungen und baut einen Abhängigkeitsgraphen auf. Diese Informationen werden dann in einem gut formatierten Markdown-Dokument zusammengestellt, das als Kontext für KI-Agenten dient.

Beispielausgabe

stack.md könnte wie folgt aussehen:

# Repo Map: mein-projekt

## Struktur

- `src/`
  - `index.js`
  - `utils/`
    - `helper.js`
  - `components/`
    - `Button.js`

## Importe

- `src/index.js` → `./utils/helper`
- `src/components/Button.js` → `react`

Voraussetzungen

• Node.js (v14 oder höher) muss installiert sein, um npx auszuführen.

Lizenz

MIT