Développeurs
CLI
Client en ligne de commande pour la plateforme S.EE
Un client en ligne de commande pour la plateforme S.EE, qui vous permet de créer et gérer des URL courtes, des extraits de texte et des fichiers directement depuis votre terminal.
Fonctionnalités
- Gestion des URL courtes: créer, mettre à jour et supprimer des liens raccourcis avec slugs personnalisés, domaines et expiration
- Extraits de texte: partager des extraits de code et des notes depuis stdin ou des fichiers
- Téléversement de fichiers: téléverser des fichiers directement ou via stdin
- Gestion des domaines et tags: lister les domaines disponibles et gérer les tags
- Protection par mot de passe: sécuriser votre contenu avec des mots de passe
- Sortie JSON: sortie lisible par machine pour les scripts
Installation
macOS
brew tap sdotee/homebrew-tap
brew install seeDebian / Ubuntu
dpkg -i see-cli_<version>_<arch>.debRHEL / Fedora
rpm -i see-cli_<version>_linux_<arch>.rpmArch Linux
yay -S see-cli
# or pre-built binary
yay -S see-cli-binDepuis les sources
go install github.com/sdotee/cli@latestTéléchargez les binaires et paquets précompilés depuis GitHub Releases.
Configuration
Définissez votre clé API via une variable d’environnement ou un flag :
# Variable d’environnement (recommandée)
export SEE_API_KEY="your-api-key"
# Ou utilisez le flag
see --api-key "your-api-key" <command>Options de configuration
| Option | Variable d’environnement | Description |
|---|---|---|
--api-key | SEE_API_KEY | Votre clé API S.EE (requise) |
--base-url | SEE_BASE_URL | URL de base API personnalisée |
--timeout | SEE_TIMEOUT | Délai d’expiration de la requête |
--json | - | Active le format de sortie JSON |
Commandes
Domaines et tags
# Lister les domaines disponibles pour les URL courtes
see domains
# Lister les domaines disponibles pour les téléversements de fichiers
see file domains
# Lister vos tags
see tagsURL courtes
# Créer une URL courte
see url create https://example.com
# Créer avec des options personnalisées
see url create https://example.com \
--slug my-link \
--domain s.ee \
--title "My Link" \
--password secret \
--expires 2024-12-31
# Mettre à jour une URL courte
see url update --domain s.ee --slug my-link --title "New Title"
# Supprimer une URL courte
see url delete --domain s.ee --slug my-linkExtraits de texte
# Créer un texte depuis stdin
echo "Hello World" | see text create --title "greeting"
# Créer un texte depuis un fichier
see text create --file ./snippet.txt --title "Code Snippet"
# Créer avec des options
cat script.sh | see text create \
--title "Shell Script" \
--domain fs.to \
--password secret \
--expires 2024-12-31
# Mettre à jour le texte
see text update --domain fs.to --slug abc123 --title "Titre mis à jour"
# Supprimer le texte
see text delete --domain fs.to --slug abc123Téléversement de fichiers
# Téléverser un fichier
see file upload ./image.png
# Téléverser avec un domaine personnalisé
see file upload ./document.pdf --domain fs.to
# Téléverser depuis stdin
cat image.png | see file upload --stdin --filename image.png
# Supprimer un fichier
see file delete <delete-hash>Sortie JSON
Utilisez le flag --json pour obtenir une sortie lisible par machine, utile pour les scripts :
see url create https://example.com --json | jq '.short_url'Exemples
Créer une URL courte et la copier dans le presse-papiers (macOS)
see url create https://example.com --json | jq -r '.short_url' | pbcopyTéléverser une capture d’écran et obtenir l’URL (Linux)
see file upload ~/screenshot.png --json | jq -r '.url'Créer des URL courtes par lot
while read url; do
see url create "$url" --json
done < urls.txt