S.EE Docs
Entwickler

CLI

Kommandozeilen-Client für die S.EE-Plattform

Ein Kommandozeilen-Client für die S.EE-Plattform, mit dem Sie Kurz-URLs, Text-Snippets und Dateien direkt aus Ihrem Terminal erstellen und verwalten können.

Funktionen

  • Kurz-URL-Verwaltung: Erstellen, aktualisieren und löschen Sie Kurzlinks mit benutzerdefinierten Slugs, Domains und Ablaufdaten
  • Text-Snippets: Teilen Sie Code-Snippets und Notizen aus stdin oder Dateien
  • Datei-Upload: Laden Sie Dateien direkt oder über stdin hoch
  • Domain- und Tag-Verwaltung: Verfügbare Domains auflisten und Tags verwalten
  • Passwortschutz: Schützen Sie Inhalte mit Passwörtern
  • JSON-Ausgabe: Maschinenlesbare Ausgabe für Skripting

Installation

macOS

brew tap sdotee/homebrew-tap
brew install see

Debian / Ubuntu

dpkg -i see-cli_<version>_<arch>.deb

RHEL / Fedora

rpm -i see-cli_<version>_linux_<arch>.rpm

Arch Linux

yay -S see-cli
# or pre-built binary
yay -S see-cli-bin

Aus dem Quellcode

go install github.com/sdotee/cli@latest

Vorgebaute Binärdateien und Pakete finden Sie in den GitHub Releases.

Konfiguration

Setzen Sie Ihren API-Key per Umgebungsvariable oder Flag:

# Umgebungsvariable (empfohlen)
export SEE_API_KEY="your-api-key"

# Oder das Flag verwenden
see --api-key "your-api-key" <command>

Konfigurationsoptionen

OptionUmgebungsvariableBeschreibung
--api-keySEE_API_KEYIhr S.EE API-Key (erforderlich)
--base-urlSEE_BASE_URLBenutzerdefinierte API-Base-URL
--timeoutSEE_TIMEOUTRequest-Timeout
--json-JSON-Ausgabeformat aktivieren

Befehle

Domains & Tags

# Verfügbare Domains für Kurz-URLs auflisten
see domains

# Verfügbare Domains für Datei-Uploads auflisten
see file domains

# Eigene Tags auflisten
see tags

Kurz-URLs

# Kurz-URL erstellen
see url create https://example.com

# Mit benutzerdefinierten Optionen erstellen
see url create https://example.com \
  --slug my-link \
  --domain s.ee \
  --title "My Link" \
  --password secret \
  --expires 2024-12-31

# Kurz-URL aktualisieren
see url update --domain s.ee --slug my-link --title "New Title"

# Kurz-URL löschen
see url delete --domain s.ee --slug my-link

Text-Snippets

# Text aus stdin erstellen
echo "Hello World" | see text create --title "greeting"

# Text aus Datei erstellen
see text create --file ./snippet.txt --title "Code Snippet"

# Mit Optionen erstellen
cat script.sh | see text create \
  --title "Shell Script" \
  --domain fs.to \
  --password secret \
  --expires 2024-12-31

# Text aktualisieren
see text update --domain fs.to --slug abc123 --title "Aktualisierter Titel"

# Text löschen
see text delete --domain fs.to --slug abc123

Datei-Upload

# Datei hochladen
see file upload ./image.png

# Mit benutzerdefinierter Domain hochladen
see file upload ./document.pdf --domain fs.to

# Aus stdin hochladen
cat image.png | see file upload --stdin --filename image.png

# Datei löschen
see file delete <delete-hash>

JSON-Ausgabe

Verwenden Sie das Flag --json für maschinenlesbare Ausgabe – nützlich für Skripting:

see url create https://example.com --json | jq '.short_url'

Beispiele

Kurz-URL erstellen und in die Zwischenablage kopieren (macOS)

see url create https://example.com --json | jq -r '.short_url' | pbcopy

Screenshot hochladen und URL erhalten (Linux)

see file upload ~/screenshot.png --json | jq -r '.url'

Kurz-URLs stapelweise erstellen

while read url; do
  see url create "$url" --json
done < urls.txt

Auf dieser Seite