WorkGraph

WorkGraph indexiert einen vom Benutzer ausgewählten Arbeitsbereich, ohne dessen Dateien zu verschieben oder hochzuladen. Es erstellt einen geschichteten Graphen Portfolio -> Area -> Project -> Artifact, stellt ihn über einen lokalen Browser, CLI und einen schreibgeschützten MCP-Server bereit und kann optional eine Obsidian-Navigationsebene generieren.

Es begann als persönliches, vibe-codiertes Werkzeug zur Navigation in einem großen, gemischten Forschungs- und Ingenieursarbeitsbereich. Die öffentliche Version entfernt maschinenspezifische Annahmen, behält aber den Workflow bei, der das Original nützlich machte: schnelle projektübergreifende Entdeckung, explizite Herkunft und strikte Trennung zwischen Quelldateien, neu aufbaubaren Indizes und kuratiertem Gedächtnis.

Was es tut

• Drill-down-Karte: Bewege dich vom gesamten Portfolio zu einem Bereich, Projekt, Dokument, Konzept, Werkzeug oder Workflow.

• Lokale Suche: SQLite-FTS-Suche über Projektmetadaten und ausgewählte Textdateien.

• Erklärbare Links: Unterscheide explizite Pfadverweise von Vorschlägen mit geringerer Konfidenz zu gemeinsamen Konzepten.

• Schreibgeschützter MCP: Lass Codex, Kimi, Reasonix oder einen anderen MCP-Client Projektkontext und wiederverwendbare Vorarbeiten abfragen.

• Optionale Obsidian-Ebene: Generiere Navigationsseiten, Konzeptindizes, Gedächtnisspiegel und eine Canvas, ohne den Arbeitsbereich zu kopieren.

• Datenschutzkontrollen: Markiere gesamte Top-Level-Bereiche als nur Metadaten und schwärze gängige Anmeldedatenmuster aus indiziertem Text.

• Kein gehosteter Dienst: Die Weboberfläche bindet an Loopback und verwendet gebündelte Frontend-Assets; die Laufzeitindizierung benötigt weder Netzwerk noch Modell-API.

Related MCP server: ContextForge

Schnellstart

Windows-Installationsprogramm

Lade das neueste Quellarchiv von Releases herunter, entpacke es und führe dann aus:

.\scripts\Install-WorkGraph.ps1 -WorkRoot "D:\MyWorkspace" -Start

Optionale Integrationen sind explizit:

.\scripts\Install-WorkGraph.ps1 `
  -WorkRoot "D:\MyWorkspace" `
  -ObsidianVault "$HOME\Documents\My Vault" `
  -SensitiveArea Personal,Finance `
  -ConfigureClients `
  -Start

Das Installationsprogramm erstellt ein projektlokales .venv, schreibt config/workgraph.json, erstellt den ersten Index und registriert optional den MCP-Server. Vorhandene Client-Dateien werden vor der Änderung gesichert.

Manuelle Installation

uv venv .venv
uv pip install --python .\.venv\Scripts\python.exe -e .
.\.venv\Scripts\python.exe -m workgraph.cli init --work-root "D:\MyWorkspace"
.\.venv\Scripts\python.exe -m workgraph.cli refresh
.\.venv\Scripts\python.exe -m workgraph.cli serve

Öffne http://127.0.0.1:8765/. Verwende unter macOS oder Linux .venv/bin/python mit denselben Modulbefehlen.

Arbeitsbereichsmodell

Die Standardkonvention behandelt die erste Verzeichnisebene als Bereich und die zweite als Projekt:

MyWorkspace/
├── Research/
│   ├── ClimateModel/
│   └── KnowledgeGraph/
├── Engineering/
│   ├── RobotArm/
│   └── CFDStudy/
└── Writing/
    └── OpenSourceGuide/

Tiefere oder gemischte Layouts können mit project_layout.area_depths und project_layout.group_depths beschrieben werden. Siehe config/workgraph.example.json und das synthetische examples/demo-workspace.

Tägliche Befehle

.\scripts\Refresh-WorkGraph.ps1
.\scripts\Start-WorkGraph.ps1 -Open
.\scripts\Status-WorkGraph.ps1
.\scripts\Stop-WorkGraph.ps1

.\.venv\Scripts\python.exe -m workgraph.cli search "finite element OCR"
.\.venv\Scripts\python.exe -m workgraph.cli context "ClimateModel"
.\.venv\Scripts\python.exe -m workgraph.cli related "KnowledgeGraph"
.\.venv\Scripts\python.exe -m workgraph.cli reuse "document rendering"

MCP-Werkzeuge

work_map, project_context, related_projects, find_reuse, work_search und graph_stats sind schreibgeschützt. Die automatische Registrierung zielt derzeit auf Codex, Kimi Code/Kimi Work und Reasonix unter Windows:

.\.venv\Scripts\python.exe -m workgraph.cli configure-clients

Für andere Clients registriere diesen stdio-Befehl:

<absolute path to python> -m workgraph.mcp --config <absolute path to workgraph.json>

Vertrauensgrenzen

• Der Arbeitsbereich bleibt die Quelle der Wahrheit; WorkGraph verschiebt oder löscht niemals Quelldateien.

• Die SQLite-Datenbank und generierte Obsidian-Seiten sind wegwerfbare Indizes.

• Sensible Bereiche legen Dateinamen und aggregierte Metadaten offen, aber ihre Inhalte werden nicht indiziert.

• Generierte Ordner wie .git, .venv, node_modules und Build-Caches sind von der semantischen Analyse ausgeschlossen.

• Binäre Office-Dateien, PDFs, Modelle und Medien sind in v0.1 nur Metadaten.

• related_to-Kanten sind Entdeckungshinweise, keine Beweise. Folge Quellpfaden, bevor du dich auf eine Behauptung verlässt.

Lies das vollständige Datenschutzmodell, bevor du vertrauliches Material indizierst.

Entwicklung

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe -m compileall -q src tests

WorkGraph ist nur zur Laufzeit-Stdlib. Cytoscape.js und Lucide sind für die Offline-Benutzeroberfläche gebündelt; ihre Hinweise finden sich in THIRD_PARTY_NOTICES.md.

Die Entwicklung ist menschlich gesteuert und KI-gestützt. Der Betreuer trägt die Verantwortung für architektonische Entscheidungen, Datenschutzgrenzen, Verifizierung, Veröffentlichungen und alle akzeptierten Änderungen; generierter Code unterliegt denselben Review- und Testanforderungen wie jeder andere Beitrag.

Beiträge sind über fokussierte Issues und Pull Requests willkommen. Siehe CONTRIBUTING.md, SECURITY.md und die Roadmap.

Lizenz

Apache-Lizenz 2.0. Siehe LICENSE.