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.

A conversa

Pilot e tasks

O Pilot é a conversa principal de cada projeto. Ele lê o código, responde e, quando o pedido pede trabalho, despacha tasks para outros agentes. Elas rodam em paralelo, cada uma numa cópia do projeto.

Pilot
Conversa com você e coordena. Um por projeto.
Task
Escreve o código de uma tarefa.
Review
Revisa o que mudou.
Testing
Escreve e roda testes.
Iris
Design e interface. Veja Iris.
Ask
Responde perguntas sobre o código sem editar nada. Fica em Código.

Como uma task anda

  1. Você pede

    Por exemplo: “adiciona cupom no carrinho e um teste para o desconto”.
  2. O Pilot divide

    Ele despacha o plano inteiro de uma vez. A task que depende de outra espera sozinha.
  3. Cada task trabalha numa cópia

    Cada uma tem a sua cópia do projeto (git worktree) e a sua branch. Duas tasks não escrevem no mesmo arquivo ao mesmo tempo, e o que você não commitou fica fora do caminho delas.
  4. O chat mostra o andamento

    Um cartão lista cada task com o CLI, o modelo, o que o agente está fazendo agora (“Editando carrinho/cupom.ts”) e há quanto tempo. A situação aparece como na fila, subindo, trabalhando, demorando ou com erro.
  5. Pergunta ou plano

    Se a task precisar de você, o cartão mostra Responder. A pergunta também entra em Precisa de você e não expira: o agente espera.
  6. Entrega

    A task termina e entra na sua branch como um commit local, ou espera a sua revisão. O resultado volta para a conversa. Veja Trabalho.

Branch da task

Peça “faz numa branch nova a partir da main” e o Forkly cria a branch sem trocar a sua pasta. As tasks saem dela e entram nela, uma depois da outra. Se você trocar de branch com tasks rodando, cada entrega vai para a branch em que a task começou.

No chat

Anexos
Mande imagem ou arquivo pelo campo de mensagem. Eles ficam na conversa.
Checklist do agente
Quando o agente divide o trabalho em passos, o chat mostra a lista e marca o que já foi feito. Vale para Claude, Codex, Cursor e opencode.
Comandos com /
No Claude, digite / para ver os comandos e skills. Tab completa.
Mensagem no meio do trabalho
No Claude, o que você manda enquanto o Pilot trabalha chega a ele na hora.
Compactação
No Claude, a conversa compacta quando fica grande, e o chat mostra quanto economizou.
Nova conversa
⌘⇧O. A setinha ao lado abre a conversa já com outro modelo. O Pilot que estava trabalhando continua até terminar.

Nesta conversa

O painel à direita do Pilot resume a conversa: Onde paramos, o Progresso das tarefas, as Alterações desde o último commit, o que está No ar, a Memória e o Uso da janela do modelo.

Quantas tasks rodam juntas: padrão de 3 por repositório e 8 agentes por projeto. As outras esperam na fila. Mude em Configurar › Agentes e modelos › Execução paralela.