---
title: Das Kommandozeilen-Tool frwrd
description: "So installierst und nutzt du frwrd, das Kommandozeilen-Tool für frwrd.to: Umgebungsvariablen und ein Beispiel für jeden Befehl."
theme: { accent: "#1f6feb", background: light }
translations: { en: help-cli }
---

# 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.

- [Der Workspace-Schlüssel](/@frwrd.to/de/hilfe-schluessel)
- [Zurück zur Hilfe](/@frwrd.to/de/hilfe)