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).

    macOS Sequoia (15.4+): se o app abrir e fechar instantaneamente, rode no terminal: xattr -dr com.apple.quarantine /Applications/Forkly.app. Solução definitiva (Apple Developer ID + notarization) chega na Etapa 9.
  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).