Boopy Context Engine

Lokale Projektintelligenz für GitHub Copilot in VS Code

Eine VS Code-Erweiterung, die Ihr Projekt im Hintergrund indexiert, eine kompakte Projektkarte führt und Copilot im Agent-Modus sechs lokale Werkzeuge für Kontext bereitstellt. Weniger Token für „ich lese das ganze Repository“, mehr für die eigentliche Aufgabe.

VS CodeCopilot AgentNur lokalOffener Quellcode
Quellcode auf GitHub → Zurück zur Software
Version0.1.8
LizenzMIT + Commons Clause
PlattformVS Code 1.99+ (Copilot-Agent-Modus)
StatusÖffentlich auf GitHub

Was es ist

BCE baut keinen eigenen Assistenten und greift nicht in den Chat oder die Agent-Schleife von Copilot ein — es ist ein zusätzlicher Werkzeuganbieter (Language Model Tools). Copilot entscheidet selbst, wann die Werkzeuge aufgerufen werden; im Prompt können Sie sie auch direkt nennen, zum Beispiel #bceFindContext.

Indexierung, Parsing, Ranking und Cache laufen im Extension Host. Im Code gibt es keinen Netzwerkaufruf und es werden keine Telemetriedaten gesendet — der Quellcode des Projekts verlässt den Rechner nicht.

Wichtigste Funktionen

Läuft komplett lokal

Indexierung, Parsing, Ranking und Cache liegen im Extension Host. Kein Netzwerkaufruf, keine Telemetrie, kein Quellcode, der den Rechner verlässt.

Spart Kontext, nicht Schritte

Statt „alles lesen“ bekommt das Modell gereihte Treffer mit exakten Zeilen. Das geschätzte Token-Budget pro Antwort ist einstellbar (Standard 4000).

Sagt, wo es unsicher ist

Parser-Ergebnisse sind als exact oder heuristic gekennzeichnet und jede Token-Zahl ist ausdrücklich als Schätzung markiert. Das Werkzeug täuscht keine Genauigkeit vor.

Gibt keine Geheimnisse zurück

Sicherheitsfilter lassen sich nicht per Konfiguration abschalten: .env, Schlüssel, Zertifikate, Credential-Dateien, Binärdateien und große Dateien werden nie indexiert oder zurückgegeben.

Sieht ungespeicherte Änderungen

Ist eine Datei geändert, wird der Editor-Puffer gelesen — das Modell sieht also keinen Code, der 50 Änderungen alt ist. Ungespeicherter Text wird nie in den Index geschrieben.

Steuerbar und messbar

Dreizehn Befehle von der vollständigen Projektanalyse bis zum lokalen Benchmark, Diagnose mit Zählern und die Möglichkeit, die Hintergrundindexierung zu pausieren.

Werkzeuge für Copilot

Jede Werkzeugbeschreibung sagt, wann der Agent sie nutzen soll und wann nicht.

Werkzeug Zweck Nutzen, wenn
bce_get_project_overview Kompakte Projektkarte: Sprachen, Frameworks, Einstiegspunkte, Module, Datenbankobjekte, Routen, Tests und Konfiguration. Das Projekt ist neu oder die Aufgabe betrifft mehrere Module.
bce_find_context Gereihte, entdoppelte Treffer mit Begründung, exakten path:line-Angaben, kurzen Ausschnitten und Token-Schätzung. Sie verantwortlichen Code, eine Tabelle, einen Endpunkt oder ein Symbol suchen.
bce_get_file_context Ein Symbol oder ein Zeilenbereich plus Importe, Abhängigkeiten und zugehörige Tests. Sie die Datei kennen und einen bestimmten Teil daraus brauchen.
bce_explain_impact Was von einem Symbol oder einer Datei abhängt — getrennt nach verifizierten Referenzen und heuristischen Schätzungen. Vor Refactoring, Umbenennen oder Löschen von Code.
bce_get_related_tests Tests, die über Konvention, Import oder Nutzung gebunden sind, plus die Konfiguration des Test-Runners. Vor dem Schreiben von Tests und nach Verhaltensänderungen.
bce_get_status Aktualität des Index, Dateizahlen, Cache-Zustand und letzte Fehler. Ergebnisse unvollständig oder veraltet wirken.

Befehle in der Palette

Alles, was sonst im Hintergrund passiert, lässt sich auch manuell über die Befehlspalette steuern.

  • BCE: Analyze Project — vollständiger Scan mit Fortschritt und Abbruchmöglichkeit
  • BCE: Rebuild Index — verwirft beide Cache-Ebenen und parst alles neu
  • BCE: Show Project Map — öffnet eine lesbare Projektkarte (nur Lesen)
  • BCE: Search Context — Schnellauswahl aus den Treffern, öffnet die Datei an der besten Zeile
  • BCE: Show Diagnostics — Zähler, Zeiten, Werkzeugnutzung, letzte Ereignisse
  • BCE: Clear Cache — leert Parse-Cache und Kontext-Cache (Index bleibt)
  • BCE: Show Usage Report — Summe aus dem lokalen Nutzungslog: geschätzte zurückgegebene Token und was die naive Alternative gekostet hätte
  • BCE: Reset Usage Log — löscht das lokale Nutzungslog nach einer Bestätigung
  • BCE: Pause Background Indexing / Resume — Dateiereignisse werden in die Warteschlange gestellt
  • BCE: Cancel Indexing — bricht den laufenden Durchgang ab, der letzte gültige Index bleibt
  • BCE: Ensure BCE Output Is Git-Ignored — wendet den verwalteten .gitignore-Block erneut an
  • BCE: Run Local Benchmark — misst Ranking-Qualität und Kontextgröße

Installation

1

Quellcode und Prüfung

Das Repository ist öffentlich. Die Prüfung umfasst Typecheck, Tests und Bundle.

git clone https://github.com/BoopyCode/BoopyContextEngine.git
cd BoopyContextEngine
npm install
npm run check
2

Entwicklungs-Host (am schnellsten)

Ordner in VS Code öffnen und F5 drücken. Ein zweites Fenster mit geladenem BCE öffnet sich — dort ein beliebiges Projekt öffnen.

3

In das eigene VS Code installieren

Paket bauen und den Ordner zu den Erweiterungen kopieren. Nach dem Neustart von VS Code zeigt die Statusleiste „bce: Indexing“ und danach „bce: Ready (n files)“.

npm run vscode:prepublish
# Ordner hierhin kopieren (oder ein .vsix aus npx @vscode/vsce package installieren):
# %USERPROFILE%\.vscode\extensions\boopycode.boopy-context-engine-0.1.4

Voraussetzungen

  • VS Code 1.99 oder neuer (Language Model Tool API)
  • Node 18+ für den Build aus dem Quellcode
  • Einzige Laufzeitabhängigkeit: ignore (im Paket gebündelt)
  • MIT-Lizenz mit der Commons Clause — kommerzielle Nutzung nur mit schriftlicher Lizenz

Was es nicht kann

Antwortqualität, Anzahl der Agent-Schritte und abgerechnete API-Nutzung kann die Erweiterung nicht messen — sie hat keinen Zugriff darauf. Der lokale Benchmark misst daher nur, was lokal messbar ist: ob die richtigen Dateien gefunden wurden und wie viele geschätzte Token es gekostet hat.

Referenzlauf auf einem Fixture mit 27 Dateien: 100 % Trefferquote, mittlere Position des ersten korrekten Treffers 1,4 und rund 60 % kleinerer Kontext als das naive Lesen der Kandidatendateien. Die Dokumentation sagt ausdrücklich, dass sich dieses Verhältnis nicht verallgemeinern lässt — prüfen Sie die Zahlen mit Ihrem eigenen Benchmark (BCE: Run Local Benchmark).

Lizenz

Der Quellcode steht unter der MIT-Lizenz mit der Commons Clause. Private, schulische, wissenschaftliche, Hobby- und nicht-kommerzielle Open-Source-Nutzung ist kostenlos.

Kommerzielle Nutzung — Einsatz im Unternehmen, Hosting als Dienst, Einbettung in ein bezahltes Produkt oder bezahlte Integrations- und Supportarbeit — erfordert eine separate schriftliche kommerzielle Lizenz von BoopyCode. Ohne sie gewährt die Lizenz keine kommerziellen Rechte.

Bei einem Verstoß erlöschen alle Rechte automatisch, und jede Kopie muss den vollständigen Lizenztext einschließlich der Commons Clause enthalten.

Links

Möchten Sie ein ähnliches Werkzeug oder Copilot in Ihre Prozesse integriert? →

Wir antworten innerhalb von 24 Stunden. Unverbindlich und kostenlos.