Documentação

CLI/auth

renamed auth

Autenticação OAuth segura. Suas credenciais nunca tocam no histórico do shell ou variáveis de ambiente.

renamed auth <command>

O comando auth gerencia a autenticação usando o fluxo OAuth de dispositivo. Ele abre seu navegador para login seguro — sem chaves de API para copiar ou segredos para expor.

Os tokens são armazenados criptografados no chaveiro do seu sistema (macOS Keychain, Linux libsecret, Windows Credential Manager), não em arquivos de texto simples.

Subcomandos

login

Autentique com sua conta renamed.to via navegador (fluxo OAuth de dispositivo).

token

Armazene um token de API manualmente. Útil para ambientes CI/CD.

logout

Remover credenciais armazenadas do chaveiro.

whoami

Exibir o usuário autenticado atualmente.

status

Verificar status de autenticação e créditos restantes.

refresh

Atualizar manualmente um token expirado.

Exemplos

Fazer login (abre o navegador):

$ renamed auth login

Abrindo navegador para autenticação...
Aguardando aprovação...
✓ Autenticado com sucesso como alex@example.com

Verificar status e créditos restantes:

$ renamed auth status

Logado como: alex@example.com
Token expira: 2026-02-08 14:30:00
Créditos restantes: 847

$ renamed auth login --no-open

Visite esta URL para autenticar:
https://renamed.to/device?code=ABCD-1234

Armazenar um token manualmente (CI/CD):

$ renamed auth token --token rnt_abc123...

✓ Token armazenado com sucesso

Verificar com quem você está logado:

$ renamed auth whoami

alex@example.com

Fazer logout:

$ renamed auth logout

✓ Logout realizado com sucesso

Opções de Login

--no-open

Não abrir o navegador automaticamente. Exibe uma URL para visitar em outro dispositivo.

--client-id <id>

ID de cliente OAuth personalizado para SSO empresarial.

--client-secret <secret>

Segredo de cliente OAuth personalizado para SSO empresarial.

--scope <scopes>

Lista separada por vírgulas de escopos OAuth a solicitar.

Opções de Token

-t, --token <token>

O token da API para armazenar.

-s, --scheme <scheme>

Esquema de autorização (padrão: Bearer).

--non-interactive

Não solicitar entrada. Sair com erro se o token estiver ausente.

Armazenamento de Token

macOS — Keychain Access

Linux — libsecret (GNOME Keyring, KWallet)

Windows — Credential Manager

Variáveis de Ambiente

RENAMED_TOKEN — Token da API para autenticação (alternativa ao auth token)

RENAMED_CLIENT_ID — ID de cliente OAuth personalizado para SSO empresarial

RENAMED_CLIENT_SECRET — Segredo de cliente OAuth personalizado para SSO empresarial

Dicas

Antes de instalar como um serviço — Sempre execute renamed auth login antes de renamed service install. O serviço precisa de credenciais em cache para operar.

Servidores sem interface — Use --no-open em servidores sem display. Copie a URL e autentique de qualquer dispositivo com um navegador.

Ambientes CI/CD — Use a variável de ambiente RENAMED_TOKEN ou o comando auth token.

Expiração de token — Os tokens são atualizados automaticamente. Se você vir erros de autenticação, execute renamed auth refresh ou faça login novamente.

Veja Também

service — implantar como serviço systemd watch — monitorar pastas para novos arquivos