Desenvolvedores
CLI
Cliente de linha de comando para a plataforma S.EE
Um cliente de linha de comando para a plataforma S.EE que permite criar e gerenciar URLs curtas, trechos de texto e arquivos diretamente pelo terminal.
Recursos
- Gerenciamento de URLs curtas: criar, atualizar e excluir links encurtados com slugs personalizados, domínios e expiração
- Trechos de texto: compartilhar trechos de código e notas via stdin ou arquivos
- Envio de arquivos: enviar arquivos diretamente ou via stdin
- Gerenciamento de domínios e tags: listar domínios disponíveis e gerenciar tags
- Proteção por senha: proteger seu conteúdo com senhas
- Saída JSON: saída legível por máquina para scripts
Instalação
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-binA partir do código-fonte
go install github.com/sdotee/cli@latestBaixe binários e pacotes pré-compilados em GitHub Releases.
Configuração
Defina sua chave de API por 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 | Sua chave de API S.EE (obrigatória) |
--base-url | SEE_BASE_URL | URL base personalizada da API |
--timeout | SEE_TIMEOUT | Tempo limite da requisição |
--json | - | Ativa o formato de saída JSON |
Comandos
Domínios e tags
# Listar domínios disponíveis para URLs curtas
see domains
# Listar domínios disponíveis para envios de arquivos
see file domains
# Listar suas tags
see tagsURLs curtas
# Criar uma URL curta
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 uma URL curta
see url update --domain s.ee --slug my-link --title "New Title"
# Excluir uma URL curta
see url delete --domain s.ee --slug my-linkTrechos de texto
# Criar texto a partir de stdin
echo "Hello World" | see text create --title "greeting"
# Criar texto a partir de arquivo
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"
# Excluir texto
see text delete --domain fs.to --slug abc123Envio de arquivos
# Enviar um arquivo
see file upload ./image.png
# Enviar com domínio personalizado
see file upload ./document.pdf --domain fs.to
# Enviar a partir de stdin
cat image.png | see file upload --stdin --filename image.png
# Excluir um arquivo
see file delete <delete-hash>Saída JSON
Use a flag --json para obter uma saída legível por máquina, útil para scripts:
see url create https://example.com --json | jq '.short_url'Exemplos
Criar uma URL curta e copiá-la para a área de transferência (macOS)
see url create https://example.com --json | jq -r '.short_url' | pbcopyEnviar uma captura de tela e obter a URL (Linux)
see file upload ~/screenshot.png --json | jq -r '.url'Criar URLs curtas em lote
while read url; do
see url create "$url" --json
done < urls.txt