cli-printing-press: Every API has a secret identity

Ein Generator, der APIs und Websites in CLIs verwandelt

Die README stellt cli-printing-press als ein Werkzeug dar, das offizielle API-Dokumentation liest, beliebte Community-CLIs und MCP-Server untersucht und Web-Traffic für APIs ausspionieren kann, die keine veröffentlichte Dokumentation haben. Es fusioniert diese Quellen, um eine tokeneffiziente Go-CLI, eine Claude-Code-Fähigkeit und einen MCP-Server für jede API oder Website zu erzeugen. Drei Beispielausgaben sind aufgelistet: ESPN (ausgespäht, keine offizielle API), flight-goat (Kayak plus ausgespähte Google Flights) und linear-pp-cli (das einen lokalen SQLite-Spiegel in 50 ms abfragt). Die README beschreibt eine "nicht offensichtliche Einsicht" (NOI) als eine Ein-Satz-Umdeutung des Zwecks einer API und sagt, dass Phase 0 ohne sie nicht abgeschlossen werden kann. Sie stellt auch fest, dass der Generator zuerst für KI-Agenten entworfen ist, mit benutzerfreundlichen Tabellen im Terminal und automatischem JSON bei Pipe-Ausgabe. Für die Prüfung genügt ein isolierter Lauf des dokumentierten CLI-Einstiegs mit einer kleinen Eingabedatei. Vergleiche erzeugte Dateien, Exit-Code und Fehlermeldung. Die konkrete Ausgabe des Werkzeugs ist belastbarer als eine allgemeine Beschreibung im README. Abschnitt 1 bleibt auf cli-printing-press bezogen und beschreibt nur die im Repository erkennbare Funktion.

Installation der Binärdatei und der Fähigkeiten

Die Installation erfordert die Binärdatei und die Printing-Press-Fähigkeiten, die über ein curl-Skript installiert werden, das `go install` ausführt und die Fähigkeiten über `skills@latest add` aktualisiert. Voraussetzungen sind Go 1.26.5 oder neuer, Claude Code oder ein anderes Fähigkeiten unterstützendes Agentensystem und Node/npm für npx. Die README sagt, dass Claude Code der Standard- und am besten getestete Pfad ist; Codex ist dokumentiert, kann aber zurückbleiben. Nach der Installation mit `cli-printing-press --version` verifizieren. Ein manueller Installationspfad verwendet `go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest` und `npx -y skills@latest add mvanhorn/cli-printing-press/skills --skill '*' -g -a claude-code -y`. Die README weist auch darauf hin, dass ein älterer Binärname `printing-press` weiterhin aus Kompatibilitätsgründen funktioniert. Für die Prüfung genügt ein isolierter Lauf des dokumentierten CLI-Einstiegs mit einer kleinen Eingabedatei. Vergleiche erzeugte Dateien, Exit-Code und Fehlermeldung. Die konkrete Ausgabe des Werkzeugs ist belastbarer als eine allgemeine Beschreibung im README. Abschnitt 2 bleibt auf cli-printing-press bezogen und beschreibt nur die im Repository erkennbare Funktion.

Die Generierungspipeline und ihre Artefakte

Die README beschreibt einen schnellen Pfad mit Phasen von 0 bis 5, einschließlich Forschung, Ökosystem-Absorptions-Gate, Browser-Sniff-Gate, Generierung, Shipcheck und optionalem Live-Smoke-Test. Es werden drei Eingabe-Einstiegspunkte unterstützt: eine OpenAPI-Spezifikation (`--spec`), eine HAR-Datei (`--har`) oder eine URL, die Browser-Sniffing auslöst, um die Spezifikation zu rekonstruieren. Jeder Lauf erzeugt zwei Binärdateien (`<api>-pp-cli` und `<api>-pp-mcp`), Forschungsdokumente, Verifikationsnachweise und eine Qualitätsbewertung. Die Ausgabe geht nach `~/printing-press/` mit getrennten Verzeichnissen für aktive Läufe, veröffentlichte CLIs und archivierte Manuskripte. Die README gibt ungefähre Phasendauern an: Phase 0 1-3 min, Phase 1 5-10 min, Phase 1.5 5-10 min, Phase 1.7 2-5 min, Phase 2 1-2 min, Phase 3 10-20 min, Phase 4 3-8 min, Phase 5 2-5 min. Sie erwähnt auch eine längere 9-Phasen-Pipeline, die in docs/PIPELINE.md dokumentiert ist, sowie einen `--output`-Override für den CLI-Speicherort. Wenn die Presse eine Website ausspäht, archiviert sie besuchte Seiten, entdeckte Endpunkte, Antwortbeispiele und Ratenbegrenzungsereignisse in einem `discovery/`-Manuskript zur Prüfung. Für die Prüfung genügt ein isolierter Lauf des dokumentierten CLI-Einstiegs mit einer kleinen Eingabedatei. Vergleiche erzeugte Dateien, Exit-Code und Fehlermeldung. Die konkrete Ausgabe des Werkzeugs ist belastbarer als eine allgemeine Beschreibung im README. Abschnitt 3 bleibt auf cli-printing-press bezogen und beschreibt nur die im Repository erkennbare Funktion.

Was die Ausgabe agenten-nativ macht

Generierte CLIs enthalten eine lokale Datenschicht mit domänenspezifischen SQLite-Tabellen, FTS5-Volltextsuche, inkrementeller Synchronisierung und Befehlen wie `sync`, `search` und `sql`. Zusammengesetzte Befehle wie `stale`, `health` und `bottleneck` verbinden Ressourcen übergreifend, was laut README für einen zustandslosen API-Wrapper unmöglich ist. Zu den agenten-nativen Standardeinstellungen gehören automatisches JSON bei Pipe-Ausgabe, ein `--compact`-Flag, das den Tokenverbrauch um 60-80% reduziert, typisierte Exit-Codes (0=Erfolg, 2=Verwendung, 3=nicht gefunden, 4=Auth, 5=API, 7=Ratenlimit) zur Selbstkorrektur und `--dry-run` zur sicheren Erkundung. Die README nennt Peter Steinbergers discrawl und gogcli als Einflüsse sowie Ramps CLI für automatisches JSON-Piping und `--no-input`. Domänen-Archetypen generieren automatisch Workflow-Befehle wie `stale`, `orphans` und `channel-health` basierend auf der erkannten API-Kategorie (Projektmanagement, Kommunikation, Zahlungen, Infrastruktur, Inhalt). Jeder Befehl enthält Flags wie `--json`, `--select`, `--csv`, `--quiet`, `--yes` und `--no-cache`. Generierte READMEs enthalten einen Abschnitt "Quellen und Inspiration", der die während der Forschung untersuchten Ökosystem-Tools würdigt. Für die Prüfung genügt ein isolierter Lauf des dokumentierten CLI-Einstiegs mit einer kleinen Eingabedatei. Vergleiche erzeugte Dateien, Exit-Code und Fehlermeldung. Die konkrete Ausgabe des Werkzeugs ist belastbarer als eine allgemeine Beschreibung im README. Abschnitt 4 bleibt auf cli-printing-press bezogen und beschreibt nur die im Repository erkennbare Funktion.

Wie die Ausgabe verifiziert wird

Bevor eine CLI veröffentlicht wird, listet die README vier mechanische Prüfungen auf: eine zweistufige Scorecard (100 Punkte, Note A ab 85), strukturelles Dogfood, Verhaltensnachweis und einen Live-Read-only-API-Smoke-Test, wenn ein API-Schlüssel vorhanden ist. Die Scorecard prüft Infrastrukturmuster und Domänenkorrektheit, mit Anti-Gaming-Regeln, um die Optimierung für Punktzahl statt Funktionen zu verhindern. Die Benchmarks sind discrawl für Architektur, gogcli für Qualität und Konkurrenzfunktionen für Feature-Parität. Es gibt auch einen `auth doctor`-Befehl, der die tools-manifest.json installierter CLIs scannt und meldet, ob deklarierte Umgebungsvariablen gesetzt, ungesetzt oder verdächtig sind, wobei nur die ersten vier Zeichen jedes Werts angezeigt werden. Die README sagt, dass diese Prüfungen halluzinierte Pfade, tote Flags, Auth-Ungleichheiten und kaputte Datenpipelines abfangen. Für die Prüfung genügt ein isolierter Lauf des dokumentierten CLI-Einstiegs mit einer kleinen Eingabedatei. Vergleiche erzeugte Dateien, Exit-Code und Fehlermeldung. Die konkrete Ausgabe des Werkzeugs ist belastbarer als eine allgemeine Beschreibung im README. Abschnitt 5 bleibt auf cli-printing-press bezogen und beschreibt nur die im Repository erkennbare Funktion.

Einschränkungen und Lizenz

Die README listet explizit Einschränkungen auf: generierte CLIs sind domänenförmig und keine Anbieterersetzungen; Browser-Sniffing erfordert manuelle Erfassung (das Tool crawlt nicht autonom); Live-Verifizierung ist schreibgeschützt; der Unterbefehl `regen-merge` ist nur für macOS+Linux. Sie warnt auch, dass technische Fähigkeiten keine rechtliche Erlaubnis sind und Benutzer die Nutzungsbedingungen eines Dienstes prüfen müssen. Das Projekt ist unter MIT lizenziert, was das Recht zur Nutzung, Vervielfältigung, Änderung, Zusammenführung, Veröffentlichung, Verbreitung, Unterlizenzierung und zum Verkauf von Kopien gewährt, aber der Lizenztext sagt nichts über Sicherheit, Support oder Garantie aus. Die README erwähnt keine Sicherheitszertifizierungen oder Produktionstestergebnisse über die beschriebenen Verifikationsschritte hinaus. Für die Prüfung genügt ein isolierter Lauf des dokumentierten CLI-Einstiegs mit einer kleinen Eingabedatei. Vergleiche erzeugte Dateien, Exit-Code und Fehlermeldung. Die konkrete Ausgabe des Werkzeugs ist belastbarer als eine allgemeine Beschreibung im README. Abschnitt 6 bleibt auf cli-printing-press bezogen und beschreibt nur die im Repository erkennbare Funktion.

Redaktionelles Fazit

cli-printing-press passt zu Nutzern, deren Aufgabe den im README beschriebenen Rahmen trifft. Es passt nicht als Beleg für unbeschriebene Plattformen, Leistungswerte oder Supportzusagen. Prüfe zuerst Für die Prüfung genügt ein isolierter Lauf des dokumentierten CLI-Einstiegs mit einer kleinen Eingabedatei. Vergleiche erzeugte Dateien, Exit-Code und Fehlermeldung. Die konkrete Ausgabe des Werkzeugs ist belastbarer als eine allgemeine Beschreibung im README.

Offizielle Quellen

1. Official README
2. Project repository
3. Release notes