Bilder mit einem einzigen Befehl komprimieren.
Dieselbe Engine wie auf der Website — im Terminal, im Build und in deinem Agenten. Node 20 oder neuer, keine Telemetrie, Bilder werden gelöscht, sobald sie komprimiert sind.
+70Lass deinen Agenten sie installieren
Schick das an Claude Code, Codex oder einen beliebigen Coding-Agenten — er liest diese Doku und richtet sich selbst ein.
Installiere mir die pipic CLI anhand dieser Doku und sag mir danach, wie ich mich anmelde: https://pipic.cc/cliWarum die CLI
Ausgabe für Agenten gemacht
NDJSON und stabile Exit-Codes, auf die ein Agent verzweigen kann — kein Fließtext, den er raten muss.
Ganzer Ordner, ein Befehl
An Ort und Stelle oder in ein neues Verzeichnis — für lokale Stapel genauso wie für Build-Ausgaben.
Einmal anmelden
Danach laufen Skripte, CI (über PIPIC_TOKEN) und Agenten unbeaufsichtigt — nichts mehr zu bestätigen.
Sicher als Standard
Ohne ausdrückliches --replace oder -o wird nichts angefasst, Schreibvorgänge sind atomar, und Dateien, die nicht kleiner würden, bleiben unangetastet.
Schnellstart
Agenten · Skill installierenInstalliere die Skill einmal, und dein Agent findet pipic von selbst — du musst das Werkzeug nie benennen und die Optionen nie wiederholen.
CLI installieren
Node 20 oder neuerSkill installieren
Claude Code, Codex, Cursor und rund 70 weitereAnmeldung bestätigen
Eine Bestätigung pro RechnerDanach einfach fragen
Kein Werkzeugname, keine Optionen- pipic login niemals selbst ausführen — die Bestätigung gehört dem Menschen.
- skipped ist kein Fehler — es nennt den Grund, etwa dass die Datei schon klein genug war.
- Nach einem Teilfehler nur die fehlgeschlagenen Dateien erneut laufen lassen — ein kompletter Neulauf verbraucht das Kontingent doppelt.
Einmalige Aufgabe oder ein Agent ohne Skills — gib ihm einfach den Befehl. Der vollständige Vertrag steht einen Abschnitt weiter unten:
Use the pipic CLI to compress the images in ./assets, replacing them in place: pipic ./assets --replace --json Run `pipic -h` for more.
Läuft dein Agent in einem Container oder einer Sandbox ohne Zugriff auf dein ~/.config? Erstelle einen Token auf deiner Kontoseite und setze dort stattdessen PIPIC_TOKEN.
Selbst ausführen
Menschen · Skripte · CIInstallation
Node 20 oder neuerNichts installiert
npxKein Browser — SSH, Container
device codeCI und Sandboxes
PIPIC_TOKENBefehle
pipic <Pfade…>Dateien oder ein Verzeichnis komprimieren. Das ist der Standardbefehl.pipic login [--no-browser]Diesen Rechner per Browser oder mit einem Gerätecode autorisieren.pipic logoutAbmelden und das Token dieses Rechners widerrufen.pipic whoamiDas angemeldete Konto und den Tarif anzeigen.pipic quotaZeigen, wie viel Kontingent diesen Monat noch übrig ist.pipic token listTokens mit Präfix und letzter Nutzung auflisten.pipic token createGibt einen Link aus, um eines auf der Website zu erstellen — aus Sicherheitsgründen passiert das Erstellen eines Tokens immer dort, nie in der CLI.pipic token revoke <id>Ein eigenes Token widerrufen, meist innerhalb einer Minute wirksam.login, logout, whoami, quota und token werden zuerst als Unterbefehle erkannt, bevor sie als Pfade behandelt werden. Um einen Ordner mit einem dieser Namen zu komprimieren, schreibe ./login oder login/ — alles mit einem Pfadtrennzeichen geht stattdessen an den Komprimierungsbefehl.
Komprimierungsoptionen
--replaceOriginale an Ort und Stelle überschreiben — atomarer Austausch, Rechte bleiben erhalten, Symlinks werden aufgelöst.
-o, --out <Verzeichnis>Ergebnisse stattdessen in dieses Verzeichnis schreiben.
--jsonNDJSON-Ausgabe, eine Zeile pro Datei — für Skripte und Agenten.
--concurrency <n>Parallele Uploads. Standard ist 4.
Du musst genau eines von --replace oder -o angeben — beide schließen sich gegenseitig aus, keins ist die Voreinstellung. Ohne eines von beiden bricht pipic mit einem Nutzungsfehler ab (Exit-Code 2).
Gut zu wissen
- Dateien werden nur zurückgeschrieben, wenn das Ergebnis wirklich kleiner ist — bereits optimierte Bilder werden übersprungen, mit Angabe des Grunds. Bei -o wird das Original trotzdem mitkopiert, sodass das Ausgabeverzeichnis immer vollständig ist.
- --replace schreibt in eine temporäre Datei und benennt sie dann um, sodass ein Ctrl-C nie eine halb geschriebene Datei hinterlässt.
- Dateien über 8 MB werden mit klarem Grund übersprungen, nie stillschweigend verworfen.
- JPG, PNG, WebP und AVIF werden unterstützt. Es wird nie Telemetrie gesendet.
- Bei -o kollidieren zwei gleichnamige Dateien aus unterschiedlichen Unterordnern: pipic meldet für beide einen Fehler, statt zu raten, welche behalten werden soll.
JSON-Ausgabevertrag
--json gibt pro Datei eine Zeile mit einem JSON-Objekt aus, mit sechs festen Feldern:
fileDer übergebene Pfad, unverändert.status"ok", "skipped" oder "error" — keine anderen Werte.beforeUrsprüngliche Größe in Bytes.afterKomprimierte Größe in Bytes — 0 bei skipped/error-Zeilen.savedEingesparte Bytes (before minus after) — nie ein Prozentwert.errorNur bei skipped- und error-Zeilen vorhanden — ein für Menschen lesbarer Grund, kein Code.Exit-Codes
Das ist ein stabiler Vertrag: Skripte und Agenten sollten nach status und dem Exit-Code verzweigen — nie nach dem Text von error.
HTTP-API
Kein Node zur Hand? Ruf dieselbe Komprimierungs-Engine direkt per HTTP auf — ein Bild pro Anfrage, kein SDK, keine multipart-Formulare.
AuthorizationBearer <token> — bei jeder Anfrage erforderlich.Content-Typeimage/png, image/jpeg, image/webp oder image/avif — erforderlich und muss zu den gesendeten Bytes passen.X-Original-NameOptional. Erst URL-kodieren — in der Antwort kommen nur die für encodeURIComponent zulässigen Zeichen zurück.BodyRohe Bilddaten, kein multipart/form-data. Ein Bild pro Anfrage, bis zu 8 MB.Antwort
200 OK liefert das komprimierte Bild als Antwortkörper — gleiches Format rein, gleiches Format raus. Content-Type spiegelt das komprimierte Format; Content-Length und X-Original-Name kommen mit, wenn verfügbar.
Token holen
Die API nutzt dieselben Personal Access Tokens wie die CLI. Melde dich mit GitHub oder Google an und erstelle eines auf deiner Kontoseite — das Klartext-Token wird nur einmal angezeigt, also sicher aufbewahren.
Fehler
Jede Antwort außer 200 liefert diesen JSON-Fehlerumschlag. Werte in deinem Code das Feld code aus, nicht den message-Text — hier ein echtes Beispiel:
400INVALID_TYPE — Content-Type fehlt oder ist kein Bildtyp; NO_FILE — Body ist leer401UNAUTHORIZED, TOKEN_EXPIRED oder TOKEN_REVOKED — erneut anmelden oder neues Token erstellen413FILE_TOO_LARGE — über 8 MB415UNSUPPORTED_TYPE — ein image/*-Typ, den wir nicht komprimieren (nur PNG, JPEG, WebP, AVIF)429RATE_LIMITED (siehe Retry-After-Header) oder MONTHLY_QUOTA_EXCEEDED — Kontingent für diesen Monat aufgebraucht502UPSTREAM_ERROR — unser Backend hat dieses Bild abgelehnt; dieselben Bytes erneut zu senden schlägt genauso fehl. Der Versuch wird deinem Kontingent gutgeschrieben503UPSTREAM_ERROR oder ALL_KEYS_EXHAUSTED — vorübergehend keine Kapazität; erneuter Versuch mit Backoff ist möglich. Der Versuch wird deinem Kontingent gutgeschriebenGut zu wissen
- Eine Anfrage zählt gegen dein Kontingent, sobald wir sie zur Komprimierung annehmen — auch wenn sie anschließend mit 400, 413 oder 415 fehlschlägt. Vorher abgelehnte Anfragen zählen nie: jedes 401, ein 429 RATE_LIMITED und eine Datei, die allein wegen ihres deklarierten Content-Length-Headers abgelehnt wird. Scheitern wir auf unserer Seite (502/503), wird dieser Versuch automatisch zurückerstattet.
Jeder Header und jeder Fehlercode, maschinenlesbar in einer Datei: /openapi.json
FAQ
Rührt ein Agent Dateien an, die ich nicht angegeben habe?
Nein — pipic verlangt ein explizites --replace oder -o <Verzeichnis>. Ohne eines von beiden verweigert es die Ausführung, und es wird nie auch nur eine Anfrage gesendet, bevor dieser Fehler gemeldet wird.
Ich habe mich einmal angemeldet — kann ein Agent pipic danach dauerhaft nutzen?
Ja. Die Anmeldedaten liegen auf diesem Rechner unter ~/.config/pipic/config.json, und jedes Tool, das als du läuft, kann sie lesen — für jeden Agenten ist keine zusätzliche Freigabe nötig.
Ein Agent meldet, er sei nicht angemeldet — was tun?
Er läuft höchstwahrscheinlich in einem Container oder einer Sandbox ohne Zugriff auf dein ~/.config. Erstelle ein Token auf deiner Kontoseite und setze es dort als PIPIC_TOKEN.
Was passiert, wenn das kostenlose Kontingent aufgebraucht ist?
pipic beendet sich mit Exit-Code 4, es wird nie automatisch etwas abgerechnet. Free umfasst 100 Bilder pro Monat, Pro erhöht das auf 5.000.
Werden meine Bilder irgendwo gespeichert?
Nein — sie werden in dem Moment vom Server gelöscht, in dem die Komprimierung fertig ist, und nichts wird langfristig aufbewahrt.