Documentação

Como usar Forkly

Guia prático pra entender o que o Forkly faz, como instalar e como aproveitar cada feature. Pra contexto de produto, veja a landing.

Colegas agendados

Forks Bot — colegas que acompanham

Um Fork é um colega que acompanha um assunto do seu projeto. Ele roda no horário que você definir, reporta o que mudou e lembra do que já viu. A diferença para um cronjob comum é a memória: sem ela, a rotina diária repete os mesmos achados todo dia até você desligar por cansaço.

  1. Ele nasce da conversa

    Peça uma análise ao Pilot. Quando ela funcionar, diga "faz isso toda manhã às 9". O Fork é criado com a instrução que acabou de dar certo — em vez de você preencher um formulário no escuro, tentando acertar de primeira sem nunca ter visto o resultado.
  2. Ele lembra entre as execuções

    O que ele aprende fica visível na conversa, num bloco âmbar. A próxima execução começa sabendo disso e fala do que mudou. Cada item sai com um clique — memória que envelheceu mal é pior que nenhuma.
  3. Ele mostra o que tocou

    Cada execução traz três ou quatro linhas do que foi lido, consultado e criado. É o que faz confiar em algo que rodou de madrugada.
  4. Ele pede seu OK

    Se mexer em código, o trabalho fica numa cópia isolada e a conversa mostra Abrir PR, Ver o diff e Descartar. Você também pode responder por frase ali mesmo — ele diz o que vai fazer e pergunta antes.
Agenda
Todo dia num horário, a cada N minutos/horas, ou só em dias escolhidos da semana. Horário perdido com o app fechado roda na próxima abertura.
Quem executa
Provider e modelo por Fork, com teto de tempo. Um Fork de leitura pode usar um modelo barato; um que mexe em código, um melhor.
Escopo
Desligado (recomendado), ele só lê o projeto e escreve o relatório. Ligado, roda em cópia isolada e o resultado cai na aba Revisar — nunca mergeia sozinho.
Saída
O relatório em arquivo sempre acontece (.forkly/reports/, em Markdown, HTML ou JSON). Em cima dele você escolhe entregar no Telegram do projeto, virar card no Backlog do quadro, ou registrar numa ferramenta via MCP — abrir a issue no Linear, por exemplo.
Até quando
Sem fim, N execuções, ou até uma data. E o Fork pode ser desligado sem ser apagado.
Forks rodam com o Forkly aberto. Se o horário passar com o app fechado, a execução acontece na próxima vez que você abrir — e o relatório diz que está recuperando um horário perdido, porque o recorte de tempo fica maior que o normal.

Você também pode simplesmente falar com ele. Pedido fora do assunto dele é atendido mesmo assim, com a memória que ele já tem daquele tema. E se você der uma preferência ("da próxima vez ignora a pasta de testes"), ele registra.