forklystudio

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.

Primeiros passos

Como usar Forkly

Forkly é um app desktop (macOS + Windows) que coordena múltiplos agentes de código trabalhando no mesmo projeto, em paralelo. Você usa os CLIs que já conhece (Claude Code, Codex, Cursor, Opencode, GitHub Copilot) — Forkly orquestra.

  1. Baixar

    Baixe a versão pro seu sistema na página de releases. macOS: arquivo .dmg. Windows: .exe (NSIS installer).

    O app é assinado e notarizado pela Apple, então abre direto no macOS — sem aviso de "app não verificado" nem comando de terminal.

  2. Conectar pelo menos um CLI

    Forkly detecta automaticamente os CLIs no PATH. Você precisa de pelo menos um instalado e autenticado:

    Em Settings → Geral → CLI paths, você ajusta caminhos personalizados se algum CLI não estiver no PATH. Forkly não precisa de chave de API — autenticação é via login do próprio CLI.

  3. Abrir um projeto

    Aponte Forkly pra qualquer pasta — repositório git existente ou diretório novo. O workspace é por projeto: memória, sessões, skills, integrações ficam isolados.

  4. Conversar com o Pilot

    Crie uma thread Pilot e descreva o que quer construir. O Pilot decompõe em tasks e despacha pra agentes Task / Review / Testing rodando em panes paralelas. Você acompanha o trabalho ao vivo.

    Pra projetos com Spec Mode (docs/begin/ com constitution.md, PRD.md, spec.md, plan.md, tasks.md), o Pilot entra em modo Blueprint e executa autônomo — veja Blueprint (Spec Mode).