Zum Hauptinhalt springen

​
Überblick

Eine command-line interface, oder CLI, ist ein Werkzeug, das du über Befehle statt über Buttons bedienst. Viele Dienste stellen CLIs bereit, damit Nutzer Repositories, Dokumente, Deployments, Logs und Workspace-Daten programmatisch verwalten können. In Happycapy musst du dir diese Befehle nicht merken. Beschreibe in natürlicher Sprache, was du erreichen möchtest. Happycapy kann das CLI installieren, die passenden Befehle wählen, sie in der Sandbox ausführen, die Ausgabe lesen und die Arbeit im selben Project fortsetzen. Ein CLI kann externe Dienste wie GitHub, Notion, Lark oder Fly.io verbinden. Es kann aber auch ein lokales Hilfswerkzeug für Dateien, Code, Medien oder Daten in der Sandbox sein.

​
Wann CLI tools sinnvoll sind

Nutze CLI tools, wenn ein Dienst nützliche Aktionen über Befehle bereitstellt:
  • Repositories, Pull Requests, Issues, Logs und Deployments bearbeiten
  • Workspace-Systeme wie Notion und Lark lesen oder aktualisieren
  • Cloud-, Datenbank- oder Infrastruktur-Befehle ausführen
  • Wiederholbare Kommandozeilenarbeit in einen Project workflow verwandeln

​
CLI oder MCP?

CLI und MCP können sich in Happycapy sehr ähnlich anfühlen: Du beschreibst das Ziel in natürlicher Sprache, und der Agent entscheidet, welche Tool-Aufrufe oder Befehle nötig sind. Der Unterschied liegt vor allem in der Verbindungsschicht. Mit CLI tools schreibt und startet Happycapy Kommandozeilenprogramme in der Sandbox. Mit MCP ruft Happycapy Tools auf, die ein MCP-Server bereitstellt. Wenn ein Dienst ein gut gepflegtes offizielles CLI hat oder die Aufgabe Deployments, Logs, Skripte, Dateien oder einmaliges Setup betrifft, ist CLI oft der direkte Weg. Wenn ein Dienst einen gepflegten MCP-Server hat oder Tool-Aktionen über eine strukturierte Schnittstelle bereitstellen soll, passt MCP möglicherweise besser. Wenn beides existiert, wähle die Option, die offiziell gepflegt, bei Berechtigungen klar und am einfachsten einzurichten ist.

​
Bevor du startest

Hilfreicher Kontext:
  • Der offizielle CLI-Name oder Installationslink
  • Das Konto, der Workspace, das Repository oder die App, die verbunden werden soll
  • Die nötige Authentifizierung, etwa Login-Flow, Token, API key oder Workspace-Berechtigung
  • Das Ergebnis, das Happycapy nach der Einrichtung erreichen soll

​
Erste Nutzung

Gib Happycapy das Tool und das Ziel: 
Installiere [CLI name] in der Happycapy-Sandbox.
Sag mir vor dem Fortfahren, welche Authentifizierung nötig ist.
Wenn alles bereit ist, nutze es für [goal].

CLI-Link: [official link]

​
Empfohlene CLIs

Diese CLIs funktionieren gut in der Happycapy-Sandbox, weil sie echte Arbeitssysteme als Befehle bereitstellen, die ein agent installieren, konfigurieren und ausführen kann.
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/github.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=679bb093797d36e654af372f853a460a

GitHub CLI

Mit Repositories, Pull Requests, Issues und GitHub Actions arbeiten.
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/notion.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=534c589e6711180fe51fa3b632720e51

ntn

Notion-Seiten suchen, Inhalte erstellen und Datenbanken abfragen.
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/lark.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=adc21fbe2f882fafdd5006135fb05128

lark-cli

Mit Lark/Feishu-Nachrichten, Docs, Sheets, Kalendern, Aufgaben, Mail und Meetings arbeiten.
https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/flyio.svg?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=d9342a993c06f2170919e5f5a526a3d3

flyctl

Fly.io apps, Machines, Logs, Secrets und Releases deployen und betreiben.

​
Beispiel-workflows

Nutze GitHub CLI.
Prüfe den letzten fehlgeschlagenen GitHub Actions run für dieses Repository.
Fasse den Fehler zusammen und schlage die kleinste sinnvolle Korrektur vor.

Nutze ntn.
Suche in unserem Notion workspace nach Onboarding-Dokumenten.
Fasse den aktuellen Prozess zusammen und liste Lücken auf.

Nutze lark-cli.
Sammle die Projektupdates dieser Woche aus Lark docs.
Erstelle daraus einen kurzen Teambericht.

Nutze flyctl.
Prüfe Status und aktuelle Logs für diese Fly.io app.
Sag mir, ob das letzte Deploy gesund ist.

​
Authentifizierung und Berechtigungen

  • Beginne mit dem Konto, Workspace, Repository oder Project, das das CLI verbinden soll.
  • Schreibe secrets möglichst nicht in Prompts. Nutze bevorzugt den normalen Authentifizierungsflow des CLI.
  • Bitte Happycapy, die benötigten Berechtigungen zu erklären, bevor du die Authentifizierung bestätigst.
  • Wenn du Tokens verwendest, nutze nach Möglichkeit scoped oder kurzlebige Tokens.
  • Bei destruktiven Aktionen kannst du Happycapy bitten, den Befehl und die erwartete Wirkung vor der Ausführung zu zeigen.

​
Fehlerbehebung

​
Das CLI lässt sich nicht installieren

Teile den offiziellen Installationslink und bitte Happycapy, Sandbox-Umgebung, Paketmanager und Plattformanforderungen zu prüfen.

​
Login fehlgeschlagen

Prüfe, ob das CLI Browser-Login, Token-Login, Workspace-Freigabe oder Umgebungsvariablen erwartet.

​
Permission denied

Bitte Happycapy zu zeigen, welche Berechtigung fehlt und ob ein anderer Token, eine andere Rolle, ein anderer Workspace, ein anderes Repository oder eine andere Organisation nötig ist.

​
Die Ausgabe ist zu breit

Grenze die Anfrage mit Repository, Project, Datumsbereich, Dateipfad, App-Name oder Befehlsziel ein.

​
Nächste Schritte

  • Lies MCP, um eine andere Art der Tool-Anbindung zu sehen. MCP fühlt sich ähnlich an wie CLI, ruft aber Tools von einem MCP-Server auf, statt Kommandozeilenprogramme in der Sandbox auszuführen.
  • Nutze Automations, wenn derselbe CLI workflow nach Zeitplan laufen soll.