Project Hub - Konfiguration

English Version

← Zurück zur Übersicht

Die Konfiguration steht in ~/.project-hub/config.yaml (unter Windows %USERPROFILE%\.project-hub\config.yaml). /project-hub:setup kopiert die Vorlage dorthin, /project-hub:configure ändert Werte interaktiv.

Der MCP-Server liest die Konfiguration einmal beim Start. Nach einer Änderung startest Du Claude Code neu.

Schlüssel, die der Server auswertet

~ wird bei allen vier Pfaden aufgelöst. knowledge_root und project_types_root stehen nicht in der Beispieldatei, der Server liest sie aber, wenn Du sie einträgst.

Standardwert von docs_root

• Mit der von /project-hub:setup kopierten Beispiel-Konfiguration lautet der Wert ~/Documents/project-hub.
• Fehlt der Schlüssel oder die ganze Konfigurationsdatei, verwendet der Server ~/.project-hub/projects.

Ein Projekt merkt sich den Pfad seines Dokumentenordners in der Datenbank. Eine spätere Änderung von docs_root verschiebt bestehende Projektordner nicht.

Weitere Schlüssel der Beispieldatei

Die Beispieldatei enthält außerdem diese Einträge, die /project-hub:configure anzeigt und schreibt:

Diese Schlüssel werden vom MCP-Server nicht ausgewertet, und die Skill-Abläufe lesen sie bis auf einen Fall nicht: add-contact nennt default_language für die Sprache einer Duplikat-Rückfrage. Den Ton eines Entwurfs bestimmt compose aus Projekttyp und Zielgruppe, nicht aus communication.default_tone.

Interaktiv ändern

/project-hub:configure zeigt die aktuellen Werte, fragt, was Du ändern willst, prüft den neuen Wert und schreibt die Datei neu. Prüfungen:

• user.email muss ein @ enthalten.
• default_language akzeptiert nur de oder en.
• communication.default_tone akzeptiert nur professional, friendly oder formal.
• Ein neuer db_path wird gegen Cloud-Sync-Ordner und Netzwerkpfade geprüft (siehe unten).

Über den Menüpunkt "Projekttypen verwalten" listest Du Projekttypen, startest /project-hub:type-creator oder löschst eigene Typen.

Beim Schreiben formatiert configure die Datei neu. Kommentare aus der Beispieldatei gehen dabei verloren.

Team-Nutzung und Datenbankpfad

Mehrere Personen können dieselbe Datenbank verwenden, wenn db_path auf einen echten Netzwerk-Share (NFS oder Samba) zeigt und alle denselben Pfad eintragen.

• Die Datenbank läuft im WAL-Modus, mehrere Leser sind möglich.
• Bei gesperrter Datenbank unternimmt der Server insgesamt bis zu fünf Versuche (vier Wiederholungen).
• Der Timeout beträgt 5 Sekunden, bei Pfaden mit /mnt/, /media/, /net/, /Volumes/ oder den Namen Dropbox, OneDrive, Google Drive und iCloud 30 Sekunden.
• Gleichzeitige Schreibzugriffe sollten selten bleiben. Eine Echtzeit-Konflikterkennung gibt es nicht.

Verwende für db_path keinen Cloud-Sync-Ordner (Dropbox, OneDrive, Google Drive, iCloud). Diese Dienste kopieren Dateien zeitversetzt, die Dateien .db, -wal und -shm können dabei auseinanderlaufen, und die Datenbank wird unbemerkt beschädigt. Setup und Configure warnen vor solchen Pfaden.

Die aktive Projektauswahl liegt in der Datenbank, nicht in der einzelnen Claude-Session. Bei einer gemeinsam genutzten Datenbank teilen sich alle Personen dieselbe "aktive" Auswahl und überschreiben sie gegenseitig.

Dokumentenordner pro Projekt

{docs_root}/{projekt-slug}/docs/
├── emails/
├── meeting-notes/
├── misc/
└── attachments/        wird beim ersten Anhang angelegt

Mehr dazu unter Technische Details.