Übersicht

Alle Commands des tm-Kommandozeilen-Tools im Überblick.

Die TaskMonkey CLI (Binary-Name tm, alternativ taskmonkey) ist das Werkzeug, mit dem du deinen Workspace lokal entwickelst, Tools testest und mit der Plattform synchronisierst. Ohne sie musst du jede Änderung in der Web-UI eintippen — mit ihr arbeitest du wie mit jedem anderen Projekt: Editor, Git, Terminal.

#Mit Claude Code im Editor arbeiten

tm pull zieht nicht nur deine Workspace-Configs, sondern auch ein .claude/-Verzeichnis und das vollständige Handbuch als Markdown ins lokale Projekt. Das hat einen sehr konkreten Effekt: wenn du Claude Code in deinem Editor öffnest, kennt es die Plattform sofort — Tool-Format, Hook-Mechanismen, ToolRunner-Verhalten, Conversation-Tests, alles. Du kannst direkt sagen „bau ein Tool, das X macht" und bekommst sofort etwas Passendes statt Generisches.

Konkret enthält .claude/:

• Skills für die wichtigsten Workspace-Operationen (Tool anlegen, Task konfigurieren, Tests schreiben)
• Subagent-Definitionen für spezialisierte Aufgaben (z. B. Prompt-Tuning, Schema-Migration)
• Allowlist-Konfigurationen für tm-Commands, sodass Claude Code typische Sync-/Test-Befehle ohne ständige Rückfragen ausführen darf

Das Handbuch unter docs/ ist dieselbe Markdown-Quelle, die diese Webseite hier rendert. Claude liest sie als Kontext und kann dir in deinem eigenen Workspace anhand der echten Plattform-Doku helfen.

#In einer Minute

# Einmalig global installieren
$ npm install -g taskmonkey-cli

# Mit der Plattform verbinden
$ tm login
✓ Eingeloggt als partner@agentur.de · Tenant: client_shop

# Config + Doku + .claude lokal pullen
$ tm pull
  ↓ 47 Config-Dateien
  ↓ .claude/   Claude-Code-Integration
  ↓ docs/      Vollständige Dokumentation

# Tool direkt testen
$ tm test-tool getRecentOrders limit=5
✓ 5 orders returned — 12ms

# Chat auf der Konsole
$ tm chat
You: Wie viele Bestellungen kamen heute rein?
⚡ getRecentOrders(since: 'today')
Bot: Heute sind 23 Bestellungen eingegangen.

# Änderungen live pushen
$ tm watch
👀 Watching — syncing on save...

#Installation

npm install -g taskmonkey-cli

Benötigt Node.js 18 oder neuer. Prüfe mit:

tm --version

#Login

tm login

Fragt E-Mail und Passwort ab, wählt (bei mehreren) den Workspace und legt eine .tmrc-Datei im aktuellen Verzeichnis an. Dieses Verzeichnis ist dann dein lokaler Workspace.

Parameter:

• -s, --server <url> — anderer Server (default https://gpt.meco-media.com). Für On-Premise-Kunden mit eigener URL relevant.

#Workflow-Commands

#Test-Commands

#Debug- & Monitor-Commands

#KI-Assistent

#.tmrc-Datei

Nach dem Login liegt eine .tmrc in deinem Arbeitsverzeichnis:

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

• commit sie nicht in ein öffentliches Repo (enthält Token)
• tenant_path sagt dem CLI, wo die Config-Dateien relativ zur .tmrc liegen — Default . (gleicher Ordner)

Token-Refresh passiert automatisch. Wenn der Refresh-Token abläuft, logge dich neu ein.

#Typischer Tag

# Morgens: neuesten Stand holen
tm pull

# Editor auf
tm watch                         # läuft im Hintergrund, auto-sync

# Tools entwickeln, mit direktem Feedback
tm test-tool myNewTool          # in einem anderen Terminal

# Prompt iterativ verbessern
tm test-chat "echte Anfrage"
tm optimize-prompt --task inventur

# Verhalten live beobachten
tm monitor                      # oder `tm logs`