Documentação
Guia do PolyFlow
Tudo o que você precisa para orquestrar seus agentes de IA em um único canvas.
Começando
O PolyFlow roda como um aplicativo desktop local, para macOS, Windows e Linux. Depois da compra, baixe o instalador na página da sua licença ou instale pelo terminal:
# macOS e Linux curl -fsSL https://polyflow.online/install.sh | sh # Windows (PowerShell) irm https://polyflow.online/install.ps1 | iex
O script baixa o instalador certo para o seu sistema, confere o checksum e instala. O PolyFlow precisa do Node.js instalado, além das CLIs que você for usar.
Para rodar em desenvolvimento, você precisa de:
- Node.js e Rust (toolchain MSVC no Windows).
- As CLIs que você quiser usar no
PATH:claude,codexouopencode.
npm install npm run desktop
A primeira compilação Rust demora mais; os caches tornam as próximas inicializações mais rápidas.
Workspaces
Cada workspace é um conjunto independente de abas, instâncias e ligações. Crie um novo pelo botão + ao lado das abas, renomeie com duplo clique e alterne sem perder o estado dos processos.
A configuração — workspaces, posições, tamanhos, instâncias, regras e ligações — é salva localmente e restaurada ao reabrir o aplicativo.
Instâncias e terminais
Cada instância é um painel no canvas. Você pode criar instâncias de Claude Code, Codex CLI, OpenCode ou um terminal puro (PowerShell ou Zsh · Ubuntu/WSL).
Os terminais são reais — portable-pty + xterm.js com WebGL — com entrada de teclado, saída em bytes e redimensionamento. Mova os painéis pelo cabeçalho e redimensione pelas alças.
Os processos são iniciados e encerrados manualmente pelo rodapé do painel. Se a CLI não estiver disponível, o erro aparece no próprio painel.
Ligações e contexto
Arraste uma ligação da direita de uma instância até a esquerda de outra para conectá-las. O contexto compartilhado combina regras globais, regras do workspace, o papel do destinatário e a instrução da ligação.
As ligações têm dois modos: manual (você copia o contexto) e automático (encaminhar, auditar ou revisar e devolver correções), disponível entre instâncias de Claude Code e Codex.
Plugins
Browser
Cada card é um Chrome headless só dele, com perfil próprio. As instâncias ligadas recebem o Playwright MCP apontando para esse navegador, sem pedir aprovação a cada clique.
Commit por IA
A CLI escolhida lê as alterações pendentes e propõe como separá-las em commits coesos. Você revisa, edita e o PolyFlow executa os commits.
PostgreSQL e Arquivos
Ligue bancos Postgres (senha fora do prompt) e pastas/PDFs indexados para que os agentes leiam e usem esses dados nas tarefas.
Memória
Memória de longo prazo com ai-memory, por workspace. Os agentes leem e escrevem no escopo do projeto.
Provedores por API
Além das CLIs, você pode cadastrar provedores por API key em qualquer serviço compatível com o formato de chat da OpenAI: DeepSeek, OpenAI, OpenRouter, Gemini, Groq, Mistral, Ollama ou LM Studio.
As keys ficam no Gerenciador de Credenciais do Windows, nunca em arquivos do PolyFlow, e não voltam para a interface.