tm pull / sync / watch

Dateien zwischen lokalem Workspace und Server abgleichen.

Diese drei Commands bilden das Herzstück des Dev-Loops: lokaler Editor → Server.

#tm pull

tm pull

Lädt alle Config-Dateien deines Workspace vom Server und schreibt sie ins lokale Verzeichnis. Überschreibt dabei bestehende lokale Dateien.

Zusätzlich kommen zwei wichtige Verzeichnisse, die deinem Editor / Claude Code helfen, die Plattform sofort zu verstehen:

• .claude/ — Skills, Subagent-Definitionen und CLI-Allowlists für Claude Code. Damit weiß Claude in deinem Workspace, wie Tools aufgebaut sind, welche Konventionen gelten, welche tm-Befehle ohne Rückfrage laufen dürfen, und wie typische Aufgaben (Tool anlegen, Test schreiben, Prompt anpassen) ablaufen.
• docs/ — das vollständige TaskMonkey-Handbuch als Markdown. Dieselbe Quelle, die unter /docs als Webseite gerendert wird. Claude liest sie als Kontext und kann auf konkrete Plattform-Konzepte verweisen statt zu raten.

Effekt im Alltag: Du öffnest deinen Workspace, sagst Claude „bau ein Tool, das die letzten 5 Bestellungen aus der Shop-API holt" — und bekommst sofort etwas, das zur Plattform passt (richtige Datei-Struktur, korrekte Tool-Felder, Logger-Aufrufe). Ohne tm pull müsstest du das gesamte Wissen jedes Mal selbst erklären.

Nutze tm pull wenn:

• Du auf einem neuen Rechner startest
• Jemand anderes Änderungen in der UI gemacht hat
• Du lokale Änderungen verworfen hast und wieder vom Server starten willst
• Sich .claude/ oder docs/ auf der Plattform aktualisiert haben (regelmäßig wieder pullen lohnt sich)

#tm sync

tm sync

Sammelt alle .php-Dateien aus deinem Workspace-Ordner (rekursiv, ohne logs/, tmp/, node_modules/, .git/) und schickt sie zum Server.

Der Server:

1. Prüft jede Datei auf PHP-Syntax (fehlerhafte Dateien werden abgewiesen, andere gehen durch)
2. Schreibt sie in den Workspace
3. Leert den Config-Cache, damit Änderungen sofort wirken
4. Schickt logs/ und tmp/ zurück — so hast du Server-Logs lokal im Editor

Beispiel-Output:

✓ 12 files synced
  tools/orders/getOrder.php
  tools/orders/listOrders.php
  assistants/bestellungen.php
  ↓ 3 runtime files (logs/, tmp/)

#Fehlerhafte Dateien

⚠ 11 files synced, 1 errors

Errors:
  tools/orders/broken.php: syntax error, unexpected ')'

Fehlerhafte Datei wird nicht hochgeladen, alle anderen schon.

#Löschen statt nur hinzufügen

tm sync --delete

Dateien, die lokal nicht (mehr) existieren, werden auch auf dem Server gelöscht. Vorsicht — aber der einzige Weg, sauber aufzuräumen, wenn du eine Datei umbenannt oder entfernt hast.

#tm watch

tm watch

Kombiniert drei Dinge:

1. File-Watcher: bei jedem Speichern einer .php-Datei → automatischer tm sync
2. Live-Log-Stream: Server-Logs laufen im Terminal mit
3. Live-Monitor: jede Tool-Ausführung erscheint live

Das ist der Default-Modus während aktiver Entwicklung: Editor auf einer Seite, tm watch auf der anderen — und du siehst sofort, was die Plattform tut, sobald du speicherst.

#Parameter

• --no-logs — Log-Stream ausschalten
• --no-monitor — Monitor-Stream ausschalten

#Abbrechen

Ctrl+C.

#Zusammenspiel mit Git

Typischer Ablauf:

git pull                 # Teamänderungen lokal holen
tm sync                  # dieselbe Logik für den Server
# ... editieren ...
tm sync                  # (oder tm watch im Hintergrund)
git add . && git commit  # verteilen

.tmrc gehört in .gitignore, der Rest deines Workspaces in die Versionskontrolle.