Das Kommandozeilen-Tool frwrd
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 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 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 verify
frwrd workspace handle acme
frwrd workspace language de
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
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.