CLI

Um cliente de linha de comandos para a plataforma S.EE, que lhe permite criar e gerir URLs curtos, fragmentos de texto e ficheiros diretamente a partir do terminal.

sdotee/cli

Funcionalidades

Gestão de URL curtos: criar, atualizar e eliminar links encurtados com slugs personalizados, domínios e expiração
Fragmentos de texto: partilhar fragmentos de código e notas a partir de stdin ou ficheiros
Carregamento de ficheiros: carregar ficheiros diretamente ou via stdin
Gestão de domínios e etiquetas: listar domínios disponíveis e gerir etiquetas
Proteção por palavra-passe: proteger o seu conteúdo com palavras-passe
Saída JSON: saída legível por máquina para scripts

Instalação

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

A partir do código-fonte

go install github.com/sdotee/cli@latest

Transfira binários e pacotes pré-compilados em GitHub Releases.

Configuração

Defina a sua chave de API através de variável de ambiente ou flag:

# Variável de ambiente (recomendada)
export SEE_API_KEY="your-api-key"

# Ou use a flag
see --api-key "your-api-key" <command>

Opções de configuração

Opção	Variável de ambiente	Descrição
`--api-key`	`SEE_API_KEY`	A sua chave de API S.EE (obrigatória)
`--base-url`	`SEE_BASE_URL`	URL base personalizada da API
`--timeout`	`SEE_TIMEOUT`	Tempo limite do pedido
`--json`	-	Ativa o formato de saída JSON

Comandos

Domínios e etiquetas

# Listar domínios disponíveis para URLs curtos
see domains

# Listar domínios disponíveis para carregamentos de ficheiros
see file domains

# Listar as suas etiquetas
see tags

URLs curtos

# Criar um URL curto
see url create https://example.com

# Criar com opções personalizadas
see url create https://example.com \
  --slug my-link \
  --domain s.ee \
  --title "My Link" \
  --password secret \
  --expires 2024-12-31

# Atualizar um URL curto
see url update --domain s.ee --slug my-link --title "New Title"

# Eliminar um URL curto
see url delete --domain s.ee --slug my-link

Fragmentos de texto

# Criar texto a partir de stdin
echo "Hello World" | see text create --title "greeting"

# Criar texto a partir de ficheiro
see text create --file ./snippet.txt --title "Code Snippet"

# Criar com opções
cat script.sh | see text create \
  --title "Shell Script" \
  --domain fs.to \
  --password secret \
  --expires 2024-12-31

# Atualizar texto
see text update --domain fs.to --slug abc123 --title "Título atualizado"

# Eliminar texto
see text delete --domain fs.to --slug abc123

Carregamento de ficheiros

# Carregar um ficheiro
see file upload ./image.png

# Carregar com domínio personalizado
see file upload ./document.pdf --domain fs.to

# Carregar a partir de stdin
cat image.png | see file upload --stdin --filename image.png

# Eliminar um ficheiro
see file delete <delete-hash>

Saída JSON

Use a flag --json para obter saída legível por máquina, útil para scripts:

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

Exemplos

Criar um URL curto e copiá-lo para a área de transferência (macOS)

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

Carregar uma captura de ecrã e obter o URL (Linux)

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

Criar URLs curtos em lote

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

Nesta página