---
type: Documentation
title: Kommandozeile (librario CLI)
description: Die librario CLI für Windows, macOS und Linux installieren, den Download
  prüfen und die ersten Befehle gegen Ihre Bibliothek ausführen.
resource: https://www.librario.de/de/docs/integration/cli
language: de
revision: d75e41348289123548dd5a5619ac67a831beca3b
tags:
- docs
- integration
---

# Kommandozeile (librario CLI)

> **Tarif-Option:**
> 
> Verfügbar in Tarifen mit **REST-API**. [Tarife vergleichen→](/de/preise)



Die librario CLI bringt Ihre Bibliothek in das Terminal. Sie suchen Publikationen, legen Datensätze an, laden PDFs hoch und erstellen eine vollständige Sicherung Ihres Kontos, ohne den Browser zu öffnen. Weil jeder Befehl Text oder JSON ausgibt, eignet sich die CLI auch für Skripte und für KI-Agenten, die im Terminal arbeiten.

Die CLI arbeitet über die [REST-API](/de/docs/integration/api) und im Namen der angemeldeten Person: Sie sieht und ändert genau das, was diese Person auch in der Web-Oberfläche sehen und ändern darf.

## Installieren

Die CLI ist eine einzelne Programmdatei für Windows (64 Bit), macOS (Apple Silicon) und Linux (64 Bit, x86 und ARM). Das Installationsskript lädt die aktuelle Version, prüft ihre Prüfsumme und legt sie in Ihrem Benutzerverzeichnis ab. Administratorrechte brauchen Sie dafür nicht.

### Windows

Öffnen Sie PowerShell und führen Sie aus:

```powershell
irm https://www.librario.de/install.ps1 | iex
```

Das Skript installiert die CLI nach `%LOCALAPPDATA%\Programs\librario` und trägt dieses Verzeichnis in Ihren Benutzer-`PATH` ein. Der Befehl `librario` funktioniert sofort in diesem Fenster und in jedem neuen.

### macOS und Linux

Öffnen Sie ein Terminal und führen Sie aus:

```bash
curl -fsSL https://www.librario.de/install.sh | bash
```

Das Skript installiert die CLI nach `~/.local/bin`, dazu die Befehlsvervollständigung für bash, zsh und fish sowie die Handbuchseiten (`man librario`). Findet Ihr Terminal `librario` danach nicht, nehmen Sie `~/.local/bin` in Ihren `PATH` auf; die letzte Meldung des Skripts zeigt die Zeile, die Sie dafür eintragen.

Für Intel-Macs gibt es keine eigene Version.

### Manuell herunterladen

Wer kein Installationsskript ausführen möchte, lädt das Archiv für sein System direkt herunter:

| System                | Download                                                 |
| --------------------- | -------------------------------------------------------- |
| Windows (64 Bit)      | [librario_windows_amd64.zip](/download/cli/windows)      |
| macOS (Apple Silicon) | [librario_darwin_arm64.tar.gz](/download/cli/macos)      |
| Linux (64 Bit, x86)   | [librario_linux_amd64.tar.gz](/download/cli/linux)       |
| Linux (64 Bit, ARM)   | [librario_linux_arm64.tar.gz](/download/cli/linux-arm64) |

Entpacken Sie das Archiv und legen Sie `librario` (unter Windows `librario.exe`) in ein Verzeichnis, das in Ihrem `PATH` steht.

### Download prüfen

Zu jeder Version gehört die Datei [checksums.txt](/download/cli/checksums) mit den SHA-256-Prüfsummen aller Archive. Laden Sie sie in dasselbe Verzeichnis wie das Archiv und vergleichen Sie:

```bash
# Linux
sha256sum --ignore-missing -c checksums.txt
# macOS
shasum -a 256 --ignore-missing -c checksums.txt
```

Unter Windows zeigt PowerShell die Prüfsumme des Archivs an; sie muss mit der Zeile für `librario_windows_amd64.zip` in `checksums.txt` übereinstimmen:

```powershell
Get-FileHash .\librario_windows_amd64.zip -Algorithm SHA256
```

Die Installationsskripte führen diese Prüfung selbst aus und brechen ab, wenn die Prüfsumme nicht passt.

## Hinweise zu Windows und macOS

Die CLI ist nicht mit einem Code-Signing-Zertifikat signiert. Je nach Weg auf Ihren Rechner meldet sich deshalb das Betriebssystem.

- **Windows SmartScreen:** Haben Sie das Archiv im Browser heruntergeladen, erscheint beim ersten Start der Hinweis **Der Computer wurde durch Windows geschützt**. Klicken Sie auf **Weitere Informationen** und dann auf **Trotzdem ausführen**. Das Installationsskript für PowerShell löst diesen Hinweis nicht aus.
- **Windows Smart App Control:** Auf manchen neu eingerichteten Windows-11-Rechnern blockiert Smart App Control unsignierte Programme, ohne eine Ausnahme anzubieten. Auf verwalteten Firmenrechnern ist diese Funktion meist ausgeschaltet. Melden Sie sich bei uns, wenn Sie davon betroffen sind.
- **Firmenrichtlinien:** Wenn Ihre IT Programme über AppLocker, App Control for Business oder eine ähnliche Richtlinie freigibt, muss sie die CLI erst zulassen, zum Beispiel über die Prüfsumme der Datei oder den Installationspfad.
- **macOS Gatekeeper:** Haben Sie das Archiv im Browser heruntergeladen, verweigert macOS beim ersten Start die Ausführung. Entfernen Sie die Quarantäne-Markierung mit `xattr -d com.apple.quarantine ./librario`. Das Installationsskript ist davon nicht betroffen.

## Erste Schritte

1. Melden Sie sich an. Geben Sie dabei die Adresse an, unter der Sie Librario im Browser öffnen:

   ```bash
   librario login --host <ihre-firma>.mylibrar.io
   ```

   Die CLI öffnet Ihren Browser. Dort melden Sie sich wie gewohnt an und stimmen der Verbindung zu. Danach liegt der Zugang im Schlüsselbund Ihres Betriebssystems (unter Windows in der Anmeldeinformationsverwaltung), nicht in einer Datei.

2. Listen Sie Publikationen auf, hier mit einem Suchbegriff:

   ```bash
   librario publications list -q "Brandschutz"
   ```

3. Lassen Sie sich alle Befehle zeigen. Jeder Befehl erklärt seine Optionen mit `--help`:

   ```bash
   librario --help
   librario publications list --help
   ```

Die Verbindung der CLI erscheint auf Ihrer Seite **Integrationen** unter **Verbundene Anwendungen**. Dort können Sie sie jederzeit widerrufen, wie unter [Verbindungen verwalten und widerrufen](/de/docs/integration/mcp#verbindungen-verwalten-und-widerrufen) beschrieben.

## Telemetrie

Die CLI sendet Nutzungsdaten an AppSignal (Rechenzentrum in der EU), damit wir Fehler und langsame Befehle früh bemerken. Beim ersten Start weist die CLI einmalig darauf hin.

- **Übertragen werden:** der Befehl (etwa `publications list`), die Version der CLI, Betriebssystem und Prozessorarchitektur, die Dauer, die Art des Ergebnisses (Erfolg oder Fehlerklasse), pro Anfrage an Librario die HTTP-Methode, der Pfad der Anfrage ohne IDs und der Statuscode, eine zufällige Anfrage-ID, mit der unser Support einen fehlgeschlagenen Aufruf in den Serverprotokollen wiederfindet, und die Adresse Ihrer Bibliothek (etwa `<ihre-firma>.mylibrar.io`).
- **Nie übertragen werden:** Argumente und Optionen, Suchbegriffe, IDs von Datensätzen, Inhalte von Anfragen und Antworten, Zugangsdaten, der Name Ihres Rechners, Ihr Benutzername und Dateipfade.

So schalten Sie die Telemetrie aus, jede Variante genügt für sich:

- `librario telemetry off` speichert die Einstellung dauerhaft. `librario telemetry status` zeigt den aktuellen Stand, `librario telemetry on` schaltet sie wieder ein.
- Die Umgebungsvariable `LIBRARIO_TELEMETRY_DISABLED=1`
- Die Umgebungsvariable `DO_NOT_TRACK=1`

Die CLI funktioniert auch ohne Internetverbindung zum Telemetrie-Dienst vollständig. Ein fehlgeschlagener Versand ändert nie das Ergebnis eines Befehls.

## Aktualisieren

Führen Sie das Installationsskript erneut aus. Es ersetzt die installierte Version durch die aktuelle.
