# Quickstart: do zero ao dashboard

> Faça login com o GitHub, instale o GitHub App na sua organização, selecione repositórios e veja seu primeiro analytics de CI. Leva cerca de cinco minutos.

Source: https://latchkey.dev/pt/documentation/quickstart

## Summary

- Faça login com o GitHub, instale o app na sua org, selecione repositórios: cerca de 5 minutos, e o teste de 30 dias começa sozinho.
- O backfill importa os últimos 30 dias de execuções concluídas, então os dashboards se preenchem em minutos; as descobertas do AI Insight vêm a cada noite.
- Job de runner opcional para começar: altere uma linha para `runs-on: latchkey-small`.

Este é o caminho mais rápido do nada a um dashboard funcional do Latchkey. Nada nele toca seus repositórios ou workflows; a única alteração de código nesta página é a troca opcional de uma linha `runs-on:` perto do fim.

**Antes de começar**
- [ ] Tenho uma **organização** do GitHub (contas pessoais não são suportadas)
- [ ] Tenho permissões de owner ou admin nessa organização
- [ ] Estou em um navegador de desktop (o dashboard é somente para desktop)

1. **Faça login com o GitHub** Acesse [latchkey.dev/sign-in](https://latchkey.dev/sign-in) e faça login com sua conta do GitHub. Use a conta do GitHub que tem acesso à organização que você quer monitorar: a instalação do app no próximo passo acontece sob esta identidade, e a pessoa que instala o app se torna o owner do workspace. Você chega ao card **Get started** do dashboard ("Welcome to Latchkey"), e seu teste de 30 dias já está em andamento, sem necessidade de cartão de crédito. Se você for interrompido em algum momento, basta fazer login novamente; a configuração retoma de onde você parou.
2. **Conecte o GitHub** O passo 1 do card Get started é **Connect GitHub**. Clique nele e o Latchkey envia você ao GitHub para instalar o app (uma breve tela intermediária explica antes o que vai acontecer). Quando o GitHub perguntar onde instalar, escolha sua **organização** (não sua conta pessoal). Você precisa de permissões de owner ou admin na organização; se você não tiver nenhuma delas, peça a um owner da organização para instalar o app ou conceder a você direitos de admin. O que o app pode e não pode acessar está descrito em [Instalar o GitHub App](/documentation/install-the-github-app).
3. **Selecione repositórios para monitorar** O passo 2 do card Get started, **Select repositories**, abre o seletor de repositórios, que lista os repositórios da sua organização com busca e um filtro de visibilidade. Selecione os que você quer que o Latchkey monitore; o contador mostra quantos seu plano permite (10 no Launch, onde todo workspace novo começa; 1 no Developer e 40 no Scale se você trocar de plano depois). Duas coisas que vale saber enquanto você escolhe: os runners gerenciados só atendem repositórios monitorados, então inclua qualquer repo que você planeja apontar para labels `latchkey-*`; e o link "Skip for now, explore the dashboard first" permite adiar isso e adicionar repositórios depois pelo dashboard. Orientações para escolher dentro de um limite de plano estão em [Gerenciando repositórios](/documentation/managing-repositories).
4. **Veja o dashboard se preencher** Após a configuração, um breve tour guiado do dashboard é oferecido; você pode pulá-lo a qualquer momento. Para cada repositório que você habilitou, o Latchkey faz o backfill das execuções de workflow concluídas recentes dos últimos 30 dias, então a maioria dos times vê dados em poucos minutos; um banner de progresso é exibido enquanto o backfill roda. Se uma página parecer vazia, verifique primeiro a barra de filtros no topo: as páginas de analytics mostram dados dos repositórios que você seleciona e pedem que você escolha um se nada estiver selecionado.
5. **Opcional: execute um job em um runner do Latchkey** Altere uma linha em qualquer workflow para experimentar um runner gerenciado e autorreparável. Depois de dar push, o job aparece como na fila no GitHub até que um runner o pegue: segundos quando um runner aquecido está disponível, cerca de 10 segundos quando um runner novo faz cold start para você. O passo a passo completo, incluindo como verificar onde o job rodou, está em [Execute seu primeiro job](/documentation/run-your-first-job).
6. **Opcional: convide seu time** Em todos os planos exceto o Developer, abra **Team** na barra lateral do dashboard para convidar colegas por e-mail ou link compartilhável (o plano Developer é para uso individual, então convites não estão disponíveis nele). Os convites concedem a função de Admin ou Member. Veja [Time e funções](/documentation/team-and-roles).

## O que esperar na primeira hora

Aqui está a sequência típica depois que você conclui o onboarding, para você saber o que é normal e o que vale uma segunda olhada:

> **Nada aparecendo?**
> Certifique-se de que um repositório está selecionado na barra de filtros no topo do dashboard, que os repositórios que você habilitou de fato executaram workflows nos últimos 30 dias, e que o filtro de intervalo de datas se sobrepõe a essa atividade. Mais em [Resolução de problemas](/documentation/troubleshooting).

## Para onde ir a partir daqui

- **Conheça o dashboard** O layout, cada destino da barra lateral, a barra de filtros e os banners que mostram o que o Latchkey está fazendo.
- **Mova um job para um runner** A alteração de uma linha, como funciona o pickup e como verificar onde o job rodou.
- **Configure notificações** Direcione quebras de pipeline, picos de custo e avisos de teste para e-mail, Slack ou seu navegador.
- **Conecte seu agente de IA** Dê ao Claude Code, Cursor ou qualquer cliente MCP acesso às suas falhas de CI, além de reexecuções de workflow opt-in e jobs avulsos em runners novos.

### Quanto tempo leva para configurar o Latchkey?

Cerca de cinco minutos: entre com o GitHub, instale o app na sua organização e selecione os repositórios. O teste de 30 dias começa sozinho, sem nenhuma etapa extra.

### Quanto tempo até eu ver dados no painel?

Minutos. Uma importação traz os últimos 30 dias de execuções concluídas assim que você seleciona os repositórios, então os painéis de custo e desempenho se preenchem sem esperar por novos builds. As descobertas do AI Insight chegam na próxima execução noturna.

### Como executo meu primeiro job em um runner Latchkey?

Mude uma linha no workflow: troque o valor de `runs-on` por `latchkey-small`. Seus steps, actions, secrets, services e matrix continuam exatamente como estão, e os labels hospedados no GitHub seguem funcionando no mesmo workflow, então dá para migrar um job por vez.

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt