> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI tools

> Führe Kommandozeilenwerkzeuge in der Happycapy-Sandbox aus.

## Ü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](/de/integrations/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:

```text theme={null}
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.

<CardGroup cols={2}>
  <Card title="GitHub CLI" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/github.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=679bb093797d36e654af372f853a460a" href="https://cli.github.com" width="560" height="560" data-path="images/integrations/logos/github.png">
    Mit Repositories, Pull Requests, Issues und GitHub Actions arbeiten.
  </Card>

  <Card title="ntn" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/notion.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=534c589e6711180fe51fa3b632720e51" href="https://developers.notion.com/cli" width="64" height="64" data-path="images/integrations/logos/notion.png">
    Notion-Seiten suchen, Inhalte erstellen und Datenbanken abfragen.
  </Card>

  <Card title="lark-cli" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/lark.png?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=adc21fbe2f882fafdd5006135fb05128" href="https://github.com/larksuite/cli" width="48" height="48" data-path="images/integrations/logos/lark.png">
    Mit Lark/Feishu-Nachrichten, Docs, Sheets, Kalendern, Aufgaben, Mail und Meetings arbeiten.
  </Card>

  <Card title="flyctl" icon="https://mintcdn.com/happycapy/9SccTkPwiYpehlgU/images/integrations/logos/flyio.svg?fit=max&auto=format&n=9SccTkPwiYpehlgU&q=85&s=d9342a993c06f2170919e5f5a526a3d3" href="https://fly.io/docs/flyctl/" width="167" height="151" data-path="images/integrations/logos/flyio.svg">
    Fly.io apps, Machines, Logs, Secrets und Releases deployen und betreiben.
  </Card>
</CardGroup>

## Beispiel-workflows

```text theme={null}
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.
```

```text theme={null}
Nutze ntn.
Suche in unserem Notion workspace nach Onboarding-Dokumenten.
Fasse den aktuellen Prozess zusammen und liste Lücken auf.
```

```text theme={null}
Nutze lark-cli.
Sammle die Projektupdates dieser Woche aus Lark docs.
Erstelle daraus einen kurzen Teambericht.
```

```text theme={null}
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](/de/integrations/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](/de/features/automations), wenn derselbe CLI workflow nach Zeitplan laufen soll.