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.

Comece aqui

Primeiros passos

O Forkly é um app para macOS e Windows. Ele põe para trabalhar no mesmo projeto os CLIs de IA que você já usa: Claude Code, Codex, Cursor, opencode, GitHub Copilot e Antigravity. Você conversa com o Pilot. Ele divide o pedido em tasks, cada task trabalha numa cópia do projeto e, no fim, entra na sua branch como um commit local.

  1. Instalar

    Baixe na página inicial: .dmg para macOS ou.exe para Windows. No Mac, também dá pelo Homebrew:

    brew install --cask henrique-cabral-dev/forkly/forkly

    O app se atualiza sozinho, inclusive quando instalado pelo Homebrew.

  2. Entrar

    Na tela Entre para continuar, escolha Google, GitHub ou Apple. A conta é grátis. Em seguida vem uma configuração inicial curta (seu nome, provedores e telemetria). Dá para pular qualquer passo.

  3. Conectar pelo menos um CLI

    O Forkly não pede chave de API: ele usa o login de cada CLI. No passo Provedores de IA, ou depois em Configurar › Contas › Outros provedores, clique em Conectar. Se o CLI não estiver instalado, o botão Instalar instala para você.

    Se o Forkly não achar um CLI que já está instalado, aponte o caminho em Configurar › Sistema › Caminhos dos CLIs.

  4. Abrir um projeto

    Clique no + da primeira coluna (ou ⌘⇧N) e escolha Pasta para abrir um projeto que já está no computador. As outras opções são Workspace, Template e Blueprint. Cada projeto aberto vira um quadradinho na primeira coluna.

  5. Pedir ao Pilot

    O projeto abre no Pilot. Escreva o que você quer, por exemplo: “adiciona cupom no carrinho da loja-web”. O Pilot lê o projeto, diz como vai fazer e despacha as tasks. Enquanto elas rodam, o chat mostra um cartão com cada uma. Se uma task fizer uma pergunta ou propor um plano, aparece o botão Responder.

  6. Conferir e juntar a entrega

    Por padrão, cada task que termina entra na sua branch como um commit local. Nada sobe para o remoto. Em Trabalho, cada entrega tem Ver o que mudou e Desfazer.

    Prefere olhar antes? Ligue Revisar cada entrega antes de juntar em Configurar › Agentes e modelos › Execução paralela. Aí cada entrega espera você com Juntar, Ver alterações, Testar e Abrir PR.

A cópia por task e a entrega como commit só existem em repositório git. Numa pasta sem git, as tasks mexem direto na pasta.