das kommandozeilen-tool frwrd
So installierst und nutzt du frwrd, das Kommandozeilen-Tool für frwrd.to: Umgebungsvariablen und ein Beispiel für jeden Befehl.
frwrd ist ein schlanker Client für die API. Es liest von der Standardeingabe, schreibt auf die Standardausgabe, gibt das JSON der API unverändert aus und endet bei einem Fehler mit 1. So taugt es für ein Shell-Skript und für den Tool-Aufruf eines Agenten.
Installieren
Release-Binaries für macOS und Linux (arm64 und amd64) hängen an jedem getaggten Release des Quell-Repositorys. Das Repository ist vorerst privat, deshalb gibt es noch keine öffentliche Download-Adresse; sie wird hier nachgetragen. Bis dahin baust du es mit Go 1.27 oder neuer aus einem Checkout des Quellcodes:
go build -o frwrd ./cmd/frwrd
Einrichten
export FRWRD_KEY=fw_...FRWRD_KEY: dein Workspace-Schlüssel. Einen Workspace anlegen oder zurückholen braucht keinen Schlüssel.FRWRD_API: die Adresse der API,https://api.frwrd.to, wenn du nichts setzt. Sie muss https sein; schlichtes http gilt nur für localhost, damit der Schlüssel nie im Klartext unterwegs ist.
frwrd ohne Argumente gibt alle Befehle aus.
Links
frwrd link create https://example.com/a/long/address -title "Beispiel" frwrd link list frwrd link show aB3xZ9 frwrd link stats aB3xZ9 -since 2026-10-01 frwrd link stats aB3xZ9 -range 7d frwrd link update aB3xZ9 -title "Neuer Titel" -tags launch,2026 frwrd link archive aB3xZ9 frwrd link qr aB3xZ9 -png -size 512 > code.png
link create nimmt auch -hash für einen eigenen Hash in einem bestätigten Workspace. link update nimmt -url, -title, -tags und -archived true|false. link qr schreibt SVG, außer du gibst -png an.
Seiten
Ein Seitenpfad ist - für die Startseite, hallo für eine andere Seite und de/hilfe für eine Seite in einer anderen Sprache.
frwrd page list frwrd page pull hallo > hallo.md frwrd page push hallo < hallo.md frwrd page push hallo -version 3 < hallo.md frwrd page stats hallo -since 2026-10-01 frwrd page stats hallo -range 1d frwrd page versions hallo frwrd page delete hallo
page pull gibt die gelesene Version auf der Standardfehlerausgabe aus. Gib sie page push als -version mit, dann schlägt das Speichern fehl, wenn die Seite inzwischen jemand geändert hat.
Workspace
frwrd workspace create acme.com frwrd workspace show frwrd workspace stats -range 7d frwrd workspace verify frwrd workspace handle acme frwrd workspace language de frwrd workspace utm -source newsletter -medium email frwrd workspace domains frwrd workspace domain add links.acme.com frwrd workspace domain remove links.acme.com frwrd workspace recover acme.com frwrd workspace recover-confirm acme.com frwrd workspace delete --confirm acme.com
workspace stats gibt die Zahlen aller deiner Links auf einmal aus: die Klicks des Zeitraums (-range 1d, 7d, der Standard, oder 30d) als Blöcke, die Summe seit dem ersten Klick (null, wenn sie gerade nicht gezählt werden konnte) und die zehn meistgeklickten Links. Die Zahlen können bis zu 5 Minuten alt sein.
workspace utm setzt die UTM-Vorgaben, die jeder neue Link bekommt (-source, -medium, -campaign, -term, -content; die Flags sind die ganze neue Menge, -clear leert sie). workspace delete löscht den Workspace und läuft nur mit der Domain des Workspace als --confirm. Einen Workspace zu löschen stoppt seinen Schlüssel und nimmt seine Seiten sofort offline; nach 7 Tagen werden die Seiten und Einstellungen gelöscht. Kurzlinks funktionieren weiter. Wer die Domain innerhalb von 7 Tagen erneut nachweist (Rückholung des Schlüssels), bekommt alles zurück; bis zu 60 Tage danach die Links. Nach 60 Tagen ist die Domain frei und die Links funktionieren ohne Besitzer weiter. Browser können Kopien einer Seite, ihres QR-Codes und der Bilder bis zu einer Stunde nach dem Löschen behalten.
workspace create gibt den Schlüssel nur einmal aus. recover-confirm liest das Recovery-Secret aus FRWRD_RECOVERY_SECRET oder von der Standardeingabe, damit es nie in deinem Shell-Verlauf landet. Die Hilfe zum Schlüssel erklärt beide Schritte der Rückholung.
