Entrar pelo terminal

Você trabalha os casos no terminal, e os comandos que registram qualquer coisa precisam saber quem você é. O /fito-login conecta a sua sessão do pi à conta Fito que você já tem.

Esta página supõe que você tem uma conta. Se não tiver, crie primeiro — Criar uma conta e entrar.

Antes de começar

Uma sessão do pi com o pacote do Fito instalado. Ele carrega em qualquer pasta.
Um navegador na mesma máquina. O login devolve os tokens por localhost, então uma sessão em uma máquina remota sem navegador não consegue concluir.
Um servidor Fito ao seu alcance. Por padrão o TUI usa o Fito hospedado, em https://fito.codes.

Entrar

Na sua sessão do pi, rode:
```
/fito-login
```

O seu navegador abre na página de login do Fito. Se ele não abrir sozinho, o terminal imprime a URL para visitar:

Opening your browser to log in to Fito…
If it does not open, visit:
  https://fito.codes/auth/login?return_to=tui&port=54321&handoff_secret=…

Entre no navegador, ou com e-mail e senha, ou com Continue with GitHub. Os dois funcionam; chegam à mesma conta.
O navegador confirma e manda você voltar:

You’re logged in Return to your terminal — the Fito CLI now has your credentials. You can close this tab.

O terminal imprime a linha de sucesso:

✓ Logged in. Credentials saved to ~/.fito/credentials (mode 0600).

Confirme que funcionou: rode qualquer comando que precise de conta, como o /fito-submit, e ele não pede mais para você entrar.

Como a entrega funciona

O /fito-login sobe um pequeno servidor na sua própria máquina, em uma porta sorteada, e diz à página de login onde encontrá-lo. Quando você termina de entrar, a página envia os tokens direto para esse servidor local.

Três coisas mantêm isso estreito:

O servidor aceita uma requisição, de uma origem — a origem web com que o TUI foi configurado.
A URL carrega um segredo de uso único, gerado para este login. O navegador o devolve, e uma requisição sem o segredo correto é recusada antes mesmo de o corpo ser lido.
Nada trafega para fora da sua máquina. Os tokens vão do seu navegador para o localhost e param aí.

Onde ficam as suas credenciais

Os tokens são escritos em ~/.fito/credentials, com modo de arquivo 0600 e modo de diretório 0700 — legíveis por você e por mais ninguém na máquina.

A sua senha nunca é escrita ali. O arquivo guarda apenas metadados de token, então uma cópia vazada expira sozinha em vez de entregar a sua conta para sempre.

Renovar e sair

O seu access token dura pouco. Na maior parte do tempo você não percebe, porque os comandos o renovam para você.

Para renovar na mão:

/fito-auth-refresh

Ele troca o refresh token guardado por um par novo e reescreve o arquivo de credenciais. Se você não estiver logado, ele diz isso e sai com código diferente de zero — nesse caso rode /fito-login.

Para sair:

/fito-logout

Ele revoga o refresh token no servidor e apaga o ~/.fito/credentials. É seguro rodar quando você já está deslogado; ele simplesmente conclui.

Apontar o TUI para outro servidor

Uma variável de ambiente, FITO_URL, move as duas metades. Quando ela não está definida, o TUI usa o Fito hospedado, em https://fito.codes. Defina-a com o endereço de outro Fito, e o TUI abre a página de login nesse endereço e chama o backend no mesmo endereço mais /api.

Uma instalação local do Fito serve as duas metades a partir de http://localhost:8000. Para usar uma, defina:

export FITO_URL=http://localhost:8000

O que vem a seguir

Encontrar um caso para trabalhar — escolha um no catálogo.
Abrir e trabalhar um caso — faça o fork, o clone e receba o briefing.
Seus dados e privacidade — o que o arquivo de credenciais guarda e o que ele não guarda.