# O que é o Latchkey?

> O Latchkey é analytics de CI/CD mais runners gerenciados e autorreparáveis para o GitHub Actions: veja quanto custam seus pipelines, por que eles falham e execute jobs em uma infraestrutura mais rápida que corrige falhas transitórias automaticamente.

Source: https://latchkey.dev/pt/documentation/what-is-latchkey

## Summary

- Latchkey = **analytics** de CI/CD + **runners gerenciados e autorreparáveis** para o GitHub Actions; use qualquer uma das metades de forma independente.
- Conecta-se por meio de um GitHub App na sua **organização**; contas pessoais são rejeitadas automaticamente.
- Teste gratuito de 30 dias em todos os planos, sem necessidade de cartão de crédito no cadastro; runners a partir de $0.0025/min com mais de 2.000 minutos gratuitos por mês.

O Latchkey faz duas coisas para times que constroem no GitHub Actions:

- **Analytics de CI/CD** Suas execuções de workflow se tornam dashboards de custo, desempenho e confiabilidade, além de recomendações de otimização por IA que você pode aplicar como pull requests.
- **Runners gerenciados e autorreparáveis** Aponte um job para `runs-on: latchkey-small` e ele será executado em uma infraestrutura rápida, efêmera e isolada que detecta e corrige falhas transitórias durante a execução.

Você pode usar qualquer uma das metades por conta própria. Muitos times começam pelo analytics para entender seus gastos e depois movem seus workflows mais pesados para os runners do Latchkey.

As duas metades são independentes porque se conectam em pontos diferentes. O analytics não precisa de nada além da instalação do GitHub App: suas execuções existentes, onde quer que rodem, chegam em fluxo e viram dashboards. Os runners são adotados um job por vez, alterando uma única linha `runs-on:`, e os labels hospedados no GitHub (`ubuntu-latest` e afins) continuam funcionando lado a lado enquanto você migra.

## Como o Latchkey se conecta ao GitHub

Não há agentes para instalar nos seus repositórios e nenhuma alteração nos seus workflows existentes até que você decida fazê-las.

"Sem agentes" merece ser detalhado. O Latchkey aprende sobre seus pipelines a partir dos eventos de workflow entregues ao GitHub App e da leitura do YAML de workflow em `.github/workflows/`. Nada é adicionado aos seus repositórios, e seu CI continua rodando exatamente como antes. O Latchkey não lê o código-fonte da sua aplicação além dos arquivos de workflow, e nunca lê seus secrets ou os valores das suas variáveis de ambiente. O modelo completo de permissões está em [Segurança e permissões do GitHub](/documentation/security-and-permissions).

> **Somente contas de organização**
> O Latchkey funciona com contas de organização do GitHub. Contas pessoais do GitHub não são suportadas: se o app for instalado em uma conta pessoal, a instalação é rejeitada e removida automaticamente.

## Como o Latchkey se compara aos runners hospedados no GitHub sozinhos

A metade de analytics funciona onde quer que seus jobs já rodem. Esta comparação é sobre a metade dos runners: o que muda quando um job passa de um runner hospedado no GitHub para um runner do Latchkey.

A adoção é incremental por design: como ambas as famílias de labels continuam funcionando lado a lado, você pode mover um job, observá-lo por uma semana e expandir a partir daí. [Execute seu primeiro job](/documentation/run-your-first-job) explica a mudança de uma linha, e a [Visão geral dos runners gerenciados](/documentation/runners-overview) tem a tabela completa de tamanhos e preços.

## Quanto custa para experimentar

Todo workspace começa com um **teste gratuito de 30 dias**, e nenhum plano pede cartão de crédito para começar: novos workspaces começam automaticamente no plano Launch, e você troca de plano depois pelo **Change Plan** do modal de billing. Os planos começam em $5/mês, e todo plano inclui minutos gratuitos de runner gerenciado por mês (2.000 no Developer, 4.000 no Launch, 6.000 no Scale). O teste roda uma vez por workspace; assinar ou trocar de plano depois não o reinicia. Veja [Planos e o teste gratuito](/documentation/plans-and-trial) para detalhes.

## O que você precisa

- Uma conta de **organização** do GitHub (não uma conta pessoal). Instalações em contas pessoais são rejeitadas e removidas automaticamente, então isto é um requisito absoluto, não uma recomendação.
- Permissões de **owner ou admin** nessa organização, para que você possa instalar o GitHub App. Se você não tiver nenhuma delas, peça a um owner da organização para instalá-lo ou para conceder a você direitos de admin.
- Um **navegador de desktop** para o dashboard. O dashboard do Latchkey é somente para desktop hoje; navegadores de celular e tablet são bloqueados após o login. [Notificações](/documentation/notifications) por e-mail, Slack e push mantêm você coberto longe da sua mesa.

## Escolha seu caminho

- **Estou avaliando o Latchkey** Comece exatamente pelo que o GitHub App pode ler e alterar, depois compare planos e termos do teste.
- **Estou pronto para configurar** O Quickstart leva você do login a um dashboard funcional em cerca de cinco minutos.
- **Estou adotando runners** Tamanhos, preços, o que torna os runners gerenciados diferentes e o que você precisa antes do seu primeiro job.
- **Estou resolvendo problemas** Correções sintoma a sintoma, de jobs na fila a dashboards vazios.

### O que é o Latchkey?

O Latchkey são duas coisas que funcionam de forma independente: analytics de CI/CD para o GitHub Actions e runners gerenciados com autorreparo. A parte de analytics mostra quanto seus pipelines custam e por que falham. A parte de runners executa os jobs em infraestrutura mais rápida que repara falhas transitórias durante a execução. Você pode adotar uma sem a outra.

### Preciso de uma organização no GitHub para usar o Latchkey?

Sim. O Latchkey se conecta por um GitHub App instalado em uma organização, e contas pessoais são rejeitadas automaticamente na instalação. Se você trabalha em uma conta pessoal, crie uma organização gratuita e transfira o repositório para ela antes de instalar.

### Quanto custa experimentar o Latchkey?

Todos os planos incluem 30 dias de teste gratuito, sem cartão de crédito no cadastro. Os runners começam em US$ 0,0025 por minuto e cada plano inclui pelo menos 2.000 minutos de runner gratuitos por mês, então um teste normalmente não custa nada.

---

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
