TaskMonkey Handbuch

tm login

Mit der Plattform verbinden und Workspace wählen.

Der erste Befehl, den du in jedem neuen Projektordner ausführst.

Aufruf

tm login

Fragt interaktiv:

  1. E-Mail — deine TaskMonkey-Zugangsdaten
  2. Passwort — maskiert
  3. Workspace wählen — nur wenn dein Account mehreren Workspaces zugeordnet ist

Ergebnis

Nach erfolgreichem Login liegt eine Datei .tmrc im aktuellen Verzeichnis:

{
  "server": "https://gpt.meco-media.com",
  "tenant": "client_shop",
  "token": "eyJ...",
  "refresh_token": "eyJ...",
  "tenant_path": "."
}

Dieses Verzeichnis ist damit dein lokales Workspace-Root. Alle weiteren tm-Befehle suchen diese Datei aufwärts im Pfad — du kannst also in einem Unterordner arbeiten und die CLI findet den passenden Workspace.

Parameter

  • -s, --server <url> — alternativen Server angeben (für On-Premise-Kunden oder Testing-Umgebungen). Default: https://gpt.meco-media.com.

Sicherheit

  • .tmrc enthält einen Access-Token. Nicht committen. Füge sie in .gitignore auf.
  • Tokens werden automatisch refresht; wenn der Refresh-Token abläuft (typisch nach Wochen Inaktivität), melde dich neu an.
  • Ein tm logout-Befehl existiert aktuell nicht — lösche die .tmrc manuell, wenn du die Session beenden willst.

Fehlerbilder

Meldung Ursache
Login fehlgeschlagen E-Mail oder Passwort falsch
Keine Tenants verfügbar Account existiert, ist aber keinem Workspace zugeordnet — Betreiber kontaktieren
fetch failed Server nicht erreichbar — Netzwerk, VPN, URL prüfen
Zuletzt aktualisiert: 2026-04-19