Das Kommandozeilen-Tool frwrd

Du nutzt die App? Zurück zu app.frwrd.to

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 ohne Argumente gibt alle Befehle aus.

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.