TeamDay CLI

Das TeamDay CLI ist eine leistungsstarke Befehlszeilenschnittstelle zur Verwaltung von Agenten, zur Ausführung von Aufgaben, zur Verfolgung von Arbeiten und zur Automatisierung von Workflows direkt von Ihrem Terminal.

Inhaltsverzeichnis

Installation

Voraussetzungen

  • Node.js 18+ oder Bun 1.0+
  • Ein TeamDay-Konto unter teamday.ai

Installation aus Source (Derzeit)

cd /path/to/teamday/packages/cli
bun install
bun link

Installation überprüfen:

teamday --version

CLI aktualisieren

cd /path/to/teamday/packages/cli
git pull
bun install

Authentifizierung

OAuth-Login (Empfohlen)

Interaktive browserbasierte Authentifizierung mit automatischer Token-Verwaltung:

teamday auth login

Was passiert:

  1. CLI generiert einen sicheren Autorisierungscode
  2. Öffnet Ihren Browser auf der TeamDay-Anmeldeseite
  3. Sie klicken "CLI autorisieren"
  4. CLI erhält automatisch OAuth-Tokens
  5. Tokens werden sicher in ~/.teamday/ gespeichert

Erstbenutzer: Wenn Sie noch keine Organisation haben, wird eine während der CLI-Autorisierung automatisch erstellt.

Auth-Status überprüfen

teamday auth status

Ausgabe:

✓ Authentifiziert

Method: oauth
User ID: abc123xyz
Organization: org_456def
Expires: in 12 minutes

Token aktualisieren

OAuth-Tokens laufen nach 15 Minuten ab. Manuell aktualisieren:

teamday auth refresh

Hinweis: Refresh-Tokens halten 90 Tage. Danach führen Sie teamday auth login erneut aus.

Abmelden

Gespeicherte Anmeldedaten löschen:

teamday auth logout

Personal Access Token (Alternative)

Verwenden Sie für Automatisierung und CI/CD PATs anstelle von OAuth:

teamday auth set-key "td_your_token_here"

Oder verwenden Sie die Umgebungsvariable:

export TEAMDAY_API_TOKEN="td_your_token_here"

Siehe API-Schlüssel-Leitfaden zum Erstellen von PATs in der Web-App.

Agenten verwalten

Alle Agenten auflisten

teamday agents list

Ausgabe:

┌──────────────────────┬────────────────┬───────────────┬────────────────────┬────────────┐
│ id                   │ name           │ role          │ systemPrompt       │ visibility │
├──────────────────────┼────────────────┼───────────────┼────────────────────┼────────────┤
│ char_abc123          │ Joe            │ Assistant     │ You are helpful... │ private    │
│ char_def456          │ Code Reviewer  │ Developer     │ Review code for... │ private    │
└──────────────────────┴────────────────┴───────────────┴────────────────────┴────────────┘

Total: 2 agent(s)

Ausgabeformate:

# Tabelle (Standard)
teamday agents list

# JSON zum Scripting
teamday agents list --format json

# YAML zur Lesbarkeit
teamday agents list --format yaml

Agent-Details abrufen

teamday agents get char_abc123

Zeigt die vollständige Agent-Konfiguration an, einschließlich:

  • System-Prompt
  • Modellkonfiguration
  • Aktivierte erweiterte Tools
  • Erstellungs-/Aktualisierungszeitstempel
  • Avatar- und Farbeinstellungen

Agent erstellen

Basis-Erstellung:

teamday agents create \
  --name "My Assistant" \
  --role "Helper" \
  --system-prompt "You are a helpful AI assistant"

Erweiterte Optionen:

teamday agents create \
  --name "Code Reviewer" \
  --role "Senior Developer" \
  --system-prompt "$(cat prompts/code-review.txt)" \
  --model "claude-3-5-sonnet-20241022" \
  --visibility private

Ausgabe:

✅ Agent erstellt:
   ID: char_xyz789
   Name: Code Reviewer
   Status: active

Agent aktualisieren

teamday agents update char_abc123 \
  --name "Updated Name" \
  --role "New Role"

System-Prompt aus Datei aktualisieren:

teamday agents update char_abc123 \
  --system-prompt "$(cat new-prompt.txt)"

Agent löschen (Archivieren)

teamday agents delete char_abc123

Ausgabe:

✅ Agent archiviert

   Hinweis: Agent wird archiviert, nicht permanent gelöscht

Archivierte Agenten:

  • Erscheinen nicht mehr in Listen
  • Können nicht ausgeführt werden
  • Ausführungsverlauf bleibt erhalten
  • Können in der Web-App wiederhergestellt werden

Agent ausführen

teamday agents exec char_abc123 "What is 2+2?"

Mit Streaming (Standard):

teamday agents exec char_abc123 \
  "Review the authentication code" \
  --space s-project123 \
  --stream

Ohne Streaming:

teamday agents exec char_abc123 \
  "Quick question" \
  --no-stream

Optionen:

  • --space <id> - Führen Sie im Workspace-Kontext aus
  • --session <id> - Setzen Sie vorhandenes Gespräch fort
  • --stream / --no-stream - Echtzeit vs. Batch
  • --timeout <ms> - Max. Ausführungszeit (Standard: 300000)

Interaktiver Chat

Starten Sie ein Gespräch mit einem Agent:

teamday agents chat char_abc123

Features:

  • Multi-Turn-Konversationen
  • Streaming-Antworten
  • Session-Persistenz
  • Beenden Sie mit Strg+C oder geben Sie exit ein

Mit Spaces arbeiten

Spaces sind Workspaces, in denen Agenten auf Dateien, Git-Repositories und Projektkolleaborationen zugreifen können.

Spaces auflisten

teamday spaces list

Ausgabe:

┌──────────────────────┬────────────────┬─────────────┬────────────┐
│ id                   │ name           │ visibility  │ members    │
├──────────────────────┼────────────────┼─────────────┼────────────┤
│ s-abc123             │ Backend API    │ private     │ user_xyz   │
│ s-def456             │ Marketing Site │ organization│ user_xyz   │
└──────────────────────┴────────────────┴─────────────┴────────────┘

Total: 2 space(s)

Space erstellen

Leerer Workspace:

teamday spaces create \
  --name "My Project" \
  --description "Backend API development" \
  --visibility private \
  --type empty

Sichtbarkeitsoptionen:

  • private - Nur Sie können darauf zugreifen
  • organization - Alle Org-Mitglieder können darauf zugreifen
  • public - Jeder mit Link kann ansehen

Ausgabe:

✅ Space erstellt:
   ID: s-new123
   Name: My Project

Space-Details abrufen

teamday spaces get s-abc123

Zeigt:

  • Space-Metadaten
  • Farbverläufe (für UI)
  • Besitzer und Mitglieder
  • Erstellungs-/Aktualisierungszeitstempel

Space löschen

teamday spaces delete s-abc123

Hinweis: Nur Space-Besitzer können löschen. Space wird archiviert (Soft Delete), nicht permanent entfernt.

Zu den Ausgabeergebnissen und weiteren Details siehe Original-Dokumentation...

Nächste Schritte

Support