Documentação

Primeiros passos

Conduit é um aplicativo desktop. Não existe uma versão hospedada para fazer login: você roda tudo na sua própria máquina, com a sua própria chave de provedor.

Instalação

Os instaladores estão na página de GitHub Releases, a versão mais recente é a build atual para Windows, macOS e Linux. Você também pode compilar a partir do código-fonte, o que leva cerca de cinco minutos em uma máquina que já tenha a toolchain.

Pré-requisitos

RequisitoVersãoObservações
Node.js20A versão usada pelo CI
pnpm10.34.4Fixado; corepack enable é o caminho mais fácil
RuststableVia rustup, com rustfmt e clippy
Visual Studio 2022 Build Tools—Só no Windows, para compilação nativa

No Windows, o repositório inclui check-setup.ps1, que verifica os quatro itens e diz exatamente o que está faltando.

Compilar e rodar

terminal
git clone REPO_URL conduit
cd conduit
pnpm install
pnpm dev

pnpm dev inicia o servidor Vite e depois o shell desktop. O primeiro build em Rust demora um pouco; os seguintes são incrementais.

ComandoO que faz
pnpm devRoda o app em modo de desenvolvimento
pnpm buildProduz um instalador nativo para a sua plataforma
pnpm checkFaz typecheck do workspace TypeScript

Plataformas suportadas

Os binários ainda não são assinados pelo sistema operacional. O macOS Gatekeeper e o Windows SmartScreen vão alertar na primeira execução porque os bundles não têm assinatura em nível de OS. Os payloads de auto-update são assinados e verificados separadamente. Compilar a partir do código-fonte evita esse aviso por completo.

Sua primeira conversa

O Conduit não deixa você conversar até ter um jeito de alcançar um modelo. Na primeira execução, o onboarding pede para você escolher um provedor e fornecer uma credencial.

Usando um provedor hospedado

  1. Abra Configurações → Provedores e chaves (⌘,).
  2. Escolha seu provedor e cole a chave de API dele.
  3. Selecione um modelo na lista que o Conduit busca desse provedor.

A chave vai para o cofre de credenciais do seu sistema operacional, Windows Credential Manager, macOS Keychain ou Linux Secret Service. O Settings guarda apenas uma referência a ela, nunca o valor. Em máquinas sem chaveiro funcional, existe um armazenamento criptografado baseado em arquivo como opt-in explícito.

Usando um modelo local, sem chave

Instale Ollama ou LM Studio, baixe um modelo e selecione esse provedor nas configurações. Nenhuma credencial é necessária e nada sai da sua máquina. Combinado com o modo somente local, que recusa provedores na nuvem de cara, o Conduit não faz nenhuma requisição à internet.

Anexe imagens e documentos com + → Anexar arquivos…, colando-os ou soltando-os no chat; em Chats, soltar em qualquer lugar do chat anexa, enquanto em outras áreas soltar adiciona o arquivo a Documentos. As imagens vão para os modelos que as aceitam. Um arquivo PDF, Word, Excel, de texto, Markdown, CSV ou HTML chega a qualquer modelo como seu texto, extraído no seu dispositivo; os modelos que leem PDF por conta própria (Claude, OpenAI, Gemini e os modelos do OpenRouter que listam entrada de arquivo) recebem também o PDF, então gráficos e páginas escaneadas são preservados. Cada anexo informa como será enviado, ou por que não será.

Edite qualquer mensagem e reenvie: editar sua última mensagem a reescreve no lugar, enquanto editar uma mensagem anterior cria um fork — uma nova conversa a partir daquele ponto — mantendo o original intacto. Exporte uma conversa em Markdown ou JSON.

Tentar novamente guarda todas as respostas. Ao tentar de novo a última resposta, a anterior fica guardada como uma versão, e um seletor ‹ 2 / 3 › sob a resposta alterna entre elas; a conversa continua a partir da que estiver à mostra. Uma resposta anterior mostra suas versões, mas não permite alternar, porque as mensagens que vieram depois dela foram escritas a partir da versão que ela tem. A seta ao lado de Tentar novamente abre o menu de modelos: o modelo que você escolher responde de novo à última pergunta, só para aquela resposta, e a conversa mantém o próprio modelo. A paleta de comandos também tem Tentar novamente com outro modelo…. Comparar, ao lado do seletor, abre as versões lado a lado no painel à direita, cada uma com o modelo que a escreveu, a resposta e o custo. Usar esta escolhe uma versão para a última resposta, e Bifurcar a partir desta versão inicia uma nova conversa que continua a partir de qualquer versão.

Continuar uma resposta cortada. Quando uma resposta para no limite de saída, a nota sob ela tem um botão Continuar. O modelo retoma de onde parou, na mesma mensagem, sem nenhuma nova mensagem sua. Funciona com todos os provedores.

O menu de modelos abre com um campo de busca: digite para filtrar a lista de todos os provedores, e Enter escolhe a primeira correspondência; os modelos de cada provedor são listados em ordem alfabética. O Esforço de raciocínio, nos ajustes de um chat e em Configurações → Padrões do chat, é Automático, Baixo, Médio ou Alto. Um esforço menor responde mais rápido e custa menos em modelos que pensam, e Automático mantém o padrão do modelo. Ele só é enviado aos modelos que o aceitam, e é mapeado para OpenAI, OpenRouter, Anthropic e Gemini.

Configurações → Uso e custo mostra em gráficos seu custo e seus tokens estimados por dia e por modelo, e conta cada chamada a um modelo, incluindo as execuções de Pesquisa e as etapas de fluxos de trabalho. Os preços vêm primeiro dos que você mesmo definir, depois do preço que o OpenRouter lista para os modelos dele e, por fim, de um instantâneo do catálogo models.dev embutido em cada versão; um modelo sem preço conhecido avisa isso em vez de mostrar $0. A mesma página pode avisar você quando o gasto estimado de hoje passar de um valor que você defina: vem desligado, aparece no máximo uma vez por dia depois de uma resposta que o ultrapasse e nunca interrompe nada. Os dias seguem o gráfico de uso, em UTC.

Provedores suportados

Vinte e três provedores vêm integrados — o endpoint compatível com OpenAI está entre eles, não é um adicional. SambaNova, DeepInfra e Novita AI listam seus preços, então os modelos deles mostram quanto custam.

ProvedorCredencialBase URL
AnthropicChave de APIEditável
OpenAIChave de APIEditável
Google GeminiChave de APIFixa
xAIChave de APIEditável
Z.aiChave de APIEditável
Moonshot AIChave de APIEditável
QwenChave de APIEditável
MiniMaxChave de APIEditável
CerebrasChave de APIEditável
SambaNovaChave de APIEditável
DeepInfraChave de APIEditável
Novita AIChave de APIEditável
NVIDIA NIMChave de APIEditável
DeepSeekChave de APIFixa
MistralChave de APIFixa
GroqChave de APIFixa
Together AIChave de APIEditável
Fireworks AIChave de APIEditável
OpenRouterChave de APIFixa
OpenCode ZenChave de APIFixa
OllamaNenhuma — localEditável
LM StudioNenhuma — localEditável
Qualquer endpoint compatível com OpenAIOpcionalEditável

A última linha cobre gateways auto-hospedados como vLLM e LiteLLM, além de qualquer provedor que ainda não tenha um adaptador dedicado: informe ao Conduit uma base URL e, se o endpoint exigir, uma chave.

Adicionando GPT, Claude, Grok, GLM, Kimi e o resto

O Conduit conversa com as famílias de modelos que as pessoas realmente usam em 2026 — GPT, Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen e MiniMax — por meio de um destes três caminhos, dependendo do modelo que você quer.

  1. Adaptador integrado. Anthropic, OpenAI, Gemini, xAI, Z.ai, Moonshot AI, Qwen, MiniMax, DeepSeek, Mistral, Groq, Together AI, Fireworks AI, Cerebras, SambaNova, DeepInfra, Novita AI e NVIDIA NIM têm cada um um provedor dedicado: escolha-o, cole a chave e carregue a lista de modelos. Isso cobre Claude, GPT, Gemini, Grok, GLM, Kimi, Qwen, MiniMax e DeepSeek diretamente — cada um vem com seu próprio endpoint padrão, então não há base URL para procurar.
  2. Um gateway. OpenCode Zen ou OpenRouter catalogam o resto atrás de uma única chave, incluindo o que mais esses serviços estiverem oferecendo no momento — o Conduit busca a lista ao vivo em vez de um catálogo fixo.
  3. Qualquer endpoint compatível com OpenAI. Para um provedor sem adaptador dedicado, ou um proxy auto-hospedado como vLLM ou SGLang, aponte o provedor compatível com OpenAI para a base URL desse endpoint e forneça uma chave se ele exigir.

O adaptador integrado do Qwen usa por padrão o endpoint internacional da DashScope, e o do Moonshot usa api.moonshot.ai — os dois campos continuam editáveis se você precisar de outra região.

Atalhos de teclado

Use Ctrl no lugar de ⌘ no Windows e no Linux.

AtalhoAção
⌘KPaleta de comandos: busca, comandos, modelos e artefatos
⌘1–⌘9Ir para Início, Chats, Slides, Escrita, Apps, Fluxos de trabalho, Caixa de entrada, Agentes, Contexto
⌘NNova conversa
⌘,Settings
⌘/Abrir esta folha de atalhos
⌘\Alternar a barra lateral
⌘JAlternar o painel de documentos
⌘⇧EExpandir o painel de artefatos, ou restaurar o layout
⌘⇧PAlternar provedor
⌘⇧WAlternar busca web neste turno
⌘⇧FCriar um fork da conversa aqui
⌘⇧CCopiar a última mensagem do assistente
EscFechar um painel ou parar uma resposta em execução

A paleta de comandos é modal: digite > para comandos, @ para artefatos, / para modelos ou texto comum para buscar em todas as mensagens que você já enviou. O Settings também tem sua própria busca no topo da folha, para você pular direto para uma configuração pelo nome em vez de percorrer as seções.

Ferramentas e conectores

Ferramentas integradas

Estas não precisam de configuração:

Uma ferramenta pede sua confirmação antes de executar, a menos que esteja marcada como somente leitura. As ferramentas integradas somente leitura rodam automaticamente, e a de um conector só se o servidor a marcar como somente leitura; qualquer outra pede sua confirmação antes de executar. A busca web vem desligada por padrão e pede consentimento na primeira vez; a busca hospedada só funciona pelo endpoint oficial da Anthropic, OpenAI ou Gemini, e cai para os backends locais acima assim que você aponta um provedor para uma base URL personalizada. As consultas a um backend de busca local vão para esse serviço; o Exa, o padrão, pode mantê-las conforme seus próprios termos.

A busca de páginas do modelo só alcança sites https públicos: nunca localhost nem um endereço da sua própria rede, e cada redirecionamento é verificado. Ela devolve o título e o texto legível de uma página em vez de HTML bruto, e lê PDFs de até 20 MB. Um PDF escaneado sem texto conta como uma página sem conteúdo.

Conectores MCP

O Conduit roda servidores Model Context Protocol como conectores supervisionados. Adicione um processo local na página de Conectores com o comando e os argumentos que o iniciam, ou aponte para um endpoint MCP remoto que fale streamable HTTP.

A ferramenta de um conector roda sem perguntar apenas se o servidor a marca como somente leitura (a indicação padrão readOnlyHint ou o campo próprio do Conduit, permissionLevel). Qualquer outra ferramenta pergunta antes, e você pode lembrar uma aprovação para um chat ou para sempre. Antes da 1.0.0-rc.6, as ferramentas da maioria dos servidores de terceiros rodavam sem perguntar, então os conectores que você já usa podem passar a pedir confirmação por ferramentas que antes rodavam em silêncio.

Em Contexto → Conectores, cada ferramenta de um conector em execução mostra o que declara: só lê, altera coisas ou sempre pergunta. Uma ferramenta que não declara nada pergunta antes de cada chamada; marque Só lê numa ferramenta em que você confia para apenas consultar, e ela roda sem perguntar em chats, agentes e fluxos de trabalho. Uma ferramenta que diz que altera coisas, ou que é sensível, continua perguntando. Quando um chat ofereceria mais de 20 ferramentas de conectores, ou as descrições ficam longas, o modelo recebe uma ferramenta search_tools em vez da lista inteira e carrega as que encontrar para aquele turno; com menos ferramentas nada muda, e as aprovações funcionam como antes. Se a sua mensagem citar um conector, as ferramentas dele são oferecidas diretamente.

O runtime reinicia servidores locais que caem com backoff, limitado a três reinícios em cinco minutos, limita a concorrência e aplica timeout de trinta segundos por chamada individual. A saída da ferramenta tem limite de tamanho e é redigida antes de chegar ao modelo, e uma proteção estrutural impede que essa saída seja reproduzida como se fosse uma instrução, a rota padrão de prompt injection por resultados de ferramentas.

Transportes: stdio local e streamable HTTP remoto já estão disponíveis hoje. O legado HTTP+SSE não é suportado.

O composer também pode trazer prompts e recursos de um conector, não só suas ferramentas: um seletor de prompt preenche os argumentos que um prompt declara antes de o resultado cair no composer para você editar, e um seletor de recurso anexa conteúdo só à próxima mensagem. O consentimento é pedido uma vez por conector, e um recurso que tenta embutir instruções é recusado e identificado, em vez de seguido silenciosamente.

Conectar um servidor na sua própria máquina é o problema da documentação. Colocar esse servidor diante de um cliente — sem configuração JSON e sem aparecer dentro do Claude Desktop — é outro. Como demonstrar um servidor MCP para um cliente compara um chat hospedado, o Claude Desktop com configuração, e entregar um cliente desktop.

O loop do agente

Quando um modelo chama uma ferramenta, o Conduit a executa e devolve o resultado para outra rodada dentro do mesmo turno. Você controla os limites em Configurações → Agente: número máximo de etapas de 1 a 50 e um limite de tempo de 30 segundos a 30 minutos. A UI do chat mostra uma linha do tempo de progresso ao vivo — raciocínio, chamadas de ferramentas e texto, na ordem real em que acontecem ao longo das rodadas, com o tempo decorrido e um aviso quando uma rodada trava — em vez de um simples indicador de carregamento.

Seus agentes

Na página Agentes você cria um agente uma vez — nome, instruções, modelo, ferramentas, os agentes a quem ele pode passar trabalho e um limite de tokens — e o usa no chat, em qualquer fluxo de trabalho ou em um horário agendado. Um fluxo de trabalho guarda uma referência ao agente, então editar o agente muda tudo onde ele é usado; apagar um agente dá a cada fluxo de trabalho que o usava uma cópia própria. Quatro agentes iniciais vêm com um perfil novo: Researcher, Writer, Reviewer e Data analyst. Um agente com Lembra ligado guarda suas próprias anotações entre as execuções, que você pode ver e editar no editor dele, e Lê permite que ele pesquise as coleções de conhecimento que você escolher.

Em um chat, digite @ na caixa de mensagem para escolher um dos seus agentes naquele turno, ou pressione Perguntar no cartão dele. Em Configurações → Agente você escolhe a quais agentes o assistente pode passar trabalho. Cada passagem roda no modelo do próprio agente e aparece como uma linha na resposta, com status, tokens, custo e tempo; Ajudantes, sob a resposta, soma tokens e custo por modelo. Várias passagens de uma vez rodam ao mesmo tempo — até 3 por padrão, de 1 a 4 em Configurações → Agente — mas os ajudantes que alteram coisas, como usar o seu computador ou uma ação de conector, continuam trabalhando um de cada vez.

Clique em uma passagem para acompanhar aquele agente: a tarefa, as chamadas de ferramentas, os tokens e o custo. Parar encerra só aquele ajudante, e Redirecionar (ou a caixa de mensagem) envia a ele uma nova instrução enquanto ele trabalha. Executar em um horário…, no cartão de um agente, dá a ele uma tarefa para fazer todo dia, em dias úteis, a cada poucas horas ou quando um feed ou uma pasta tiver algo novo; cada resposta cai em Resultados, com uma notificação opcional, e Transformar em fluxo de trabalho converte uma rotina em um fluxo de trabalho comum que você pode editar. O menu ⋯ do painel de documento pode enviar um documento HTML, Markdown ou de texto de um chat ao seu agente Reviewer; se ele encontrar problemas, o chat revisa o mesmo documento.

Artefatos

Saídas mais longas, documentos, scripts e pequenas páginas web se abrem em um painel ao lado da conversa em vez de preencher a rolagem das mensagens. O Conduit renderiza texto, código com destaque de sintaxe, JSON como árvore recolhível, Markdown, incluindo diagramas Mermaid e matemática com KaTeX, e HTML interativo.

O HTML interativo roda dentro de um frame com sandbox que permite scripts e nada mais: sem acesso same-origin, sem popups e sem navegação de nível superior. Os formulários funcionam — o Conduit entrega à página o evento submit dela, e nada é enviado a lugar nenhum ao enviar. Uma política de conteúdo injetada define connect-src 'none', então a página não consegue fazer fetch nem abrir sockets por conta própria, e o Conduit a serve a partir de um endereço próprio com sandbox. A página não consegue chamar os comandos da própria aplicação. Uma exceção, um problema conhecido no macOS: o script de uma página ainda pode abrir uma conexão WebRTC, que a política de conteúdo não cobre; o Windows e o Linux a bloqueiam no webview. Se você precisar que um artefato carregue imagens ou fontes de um host específico, pode ampliar isso manualmente na parte de Segurança de artefatos de Configurações → Privacidade e dados.

Uma página que precise de dados em tempo real — uma cotação, o clima — ainda pode pedir isso. As chamadas fetch() dela vão para o Conduit, que retém a primeira solicitação a cada site novo e mostra um aviso com o nome dele. Você pode permitir esse site uma vez, sempre para essa página, ou nunca, ou deixar a página acessar qualquer site público. O Conduit então faz a solicitação por conta própria: só https, sem cookies ou logins salvos, sem endereços locais ou privados, com um tempo limite de 20 segundos, um limite de 5 MB por resposta e 120 solicitações por minuto por página. O botão de globo acima da página lista cada site que ela pediu e cada solicitação que fez. As permissões pertencem a essa página e são apagadas com ela. O modo somente local recusa tudo isso, e Páginas podem se conectar à internet, nas mesmas configurações de Segurança de artefatos, desliga isso.

Cole um bloco de código cercado por fences em uma conversa e o Conduit oferecerá promovê-lo a um artefato. Os artefatos podem ser exportados para o disco, opcionalmente com um sidecar de metadados.

Cada artefato guarda um payload atual. Não existe histórico de versões: editar substitui o conteúdo no lugar, então exporte qualquer coisa da qual você queira manter uma cópia.

Documentos

Crie uma coleção em Documents, na barra lateral, e então adicione arquivos — texto simples, Markdown, CSV, HTML, Word (.docx), Excel (.xlsx) ou PDF. Num arquivo HTML, o Conduit lê o título e o texto da página e deixa de fora scripts, estilos e outros códigos. Solte um arquivo em qualquer lugar da janela fora de Chats para adicioná-lo, ou anexe uma coleção inteira pelo composer para uma única conversa. Uma resposta mostra os arquivos em que se baseou como chips clicáveis; clique em um para ver a passagem exata.

Só um arquivo? Anexe-o à mensagem: + → Anexar arquivos…, cole-o ou solte-o no chat. Nada é indexado e nenhum provedor de embeddings entra em cena. O modelo recebe o texto do documento, extraído no seu dispositivo, e um modelo que lê PDF recebe também o próprio PDF. Nos dois casos o conteúdo vai para o provedor de chat que você escolheu, como parte da sua mensagem; escolha o Ollama ou o LM Studio e ele fica na sua máquina. Um PDF acima de 20 MB vai só como texto, e o texto de um documento longo é cortado em 150.000 caracteres.

Cada coleção é embedada por um único provedor — OpenAI, Gemini, OpenRouter ou Ollama (o Anthropic não consegue gerar embeddings). A indexação envia o texto completo de um documento para esse provedor, então o Conduit pede consentimento na primeira vez, lembra sua resposta por provedor, e você pode revogá-la depois na página de Documentos. Escolha o Ollama e nada sai da sua máquina — o modo somente local força essa escolha. A busca em si é híbrida: similaridade vetorial mais busca por palavra-chave sobre o mesmo banco SQLite local, e as passagens recuperadas continuam indo para o provedor que responde na conversa.

A leitura acontece no próprio dispositivo, sem nenhuma etapa de OCR, então um PDF escaneado sem camada de texto não gera nada — o Conduit avisa quando isso acontece em vez de importar um documento vazio. Anexado a uma mensagem, porém, um PDF escaneado ainda pode ser lido por um modelo que lê PDF, já que esse modelo recebe o próprio PDF.

Projetos

Dê a todos os chats de um projeto as mesmas instruções, documentos e skills. Projetos, na lista de chats, agrupa chats em um só nível, sem aninhamento; um projeto sem configurações é simplesmente uma pasta. O menu ⋯ de um projeto tem Novo chat aqui, Configurações do projeto, Renomear e Excluir. Excluir pede confirmação e mantém os chats: eles saem do projeto. Em Configurações do projeto:

Um projeto se soma às suas configurações em vez de substituí-las. As instruções se empilham em ordem, cada uma com seu rótulo: as suas, de Configurações, depois as do projeto, depois as do próprio chat. Coleções e skills são as do projeto mais as que o chat adicionar. No composer, um chip de projeto mostra em qual projeto o chat está, e as configurações do chat listam o que ele também usa de Configurações e do projeto. As configurações de um projeto são lidas quando você envia uma mensagem, então editar um projeto muda todos os chats dele, e mover um chat para dentro ou para fora vale a partir da próxima mensagem. A exceção é a pasta de trabalho: ela é copiada quando o chat é criado, então os chats que já estão no projeto mantêm a deles.

Geração de imagens

OpenAI, Gemini e OpenRouter conseguem gerar imagens direto em uma conversa. O Conduit pede uma vez, antes da primeira imagem, já que cada uma é cobrada pelo provedor — só falar sobre geração de imagens não dispara esse pedido. O resultado é salvo localmente como um artefato em vez de vinculado ao provedor, então não expira.

Apps pessoais

Uma página que vale a pena guardar pode ser salva como app pessoal: Salvar como app no menu ⋯ da página cria uma cópia que você abre em Apps na barra de navegação, ou em Seus apps na tela de novo chat. A cópia continua funcionando depois que você apaga o chat. Ao salvar, o Conduit pergunta quais permissões de site da página manter, uma a uma, e não mantém nenhuma que você não marcar. Quando a página do chat muda depois, o app oferece Atualizar. Oito apps iniciais já vêm incluídos; adicione um pela página Apps, ou pressione Abrir app em uma ideia que tenha um.

Uma página (um app, ou uma em um chat) pode declarar mais três coisas, cada uma verificada pelo Conduit. Ela pode guardar dados entre as aberturas — até 5 MB por página, armazenados junto com o resto dos seus dados e criptografados quando a criptografia em repouso está ativada; Limpar dados os remove. Pode receber algumas configurações, como uma cidade, que o Conduit pede em um formulário próprio e repassa à página em execução sem recarregá-la. E pode perguntar ao seu modelo de IA, depois que você permitir isso para aquela página: o aviso nomeia o provedor e diz quando o texto sairia do seu dispositivo, e a página recebe texto de entrada e texto de saída — sem ferramentas, histórico de chat, memória nem documentos.

Cada app pessoal tem sua própria página de Configurações (a engrenagem no cabeçalho do app, ou ⋯ → Configurações): qual modelo responde, tokens por dia com um limite diário para modelos na nuvem (100.000 por padrão; modelos no seu computador nunca têm limite), seus dados salvos chave por chave com Exportar e Limpar, os sites e provedores que ele pode usar e uma semana de registros de atividade de uma linha — nunca prompts, respostas ou valores salvos.

Slides

Descreva a história, ou peça uma apresentação em qualquer chat, e o Conduit redige uma narrativa para você aprovar e depois monta uma apresentação ao vivo: cada mudança edita essa mesma apresentação em vez de gerar mais uma cópia. Ela abre em um estúdio, com o slide grande no centro e o chat ao lado. Peça uma mudança e o assistente edita um único slide, ou troca uma palavra na apresentação inteira.

Montada com partes. O assistente não escreve o HTML de um slide: ele escolhe um layout e preenche suas partes — um título, tópicos, números com seus rótulos, colunas, uma citação — e o Conduit diagrama o slide no tema. Um texto longo demais para o seu lugar volta ao assistente com o que deve ser encurtado antes de o slide ser criado. Resta um layout livre para os slides em que nenhum layout se encaixa. O texto que ainda assim não cabe diminui passo a passo, até um tamanho legível, em vez de se sobrepor ou sair do slide, e o HTML e o PDF exportados correspondem ao que você vê.

Gráficos a partir dos seus números. Os gráficos de barras, de linhas e de funil são desenhados pelo Conduit a partir dos dados que o assistente fornece: eixos que começam no zero, barras proporcionais, rótulos que não colidem e tamanhos legíveis do fundo de uma sala. Um layout de gráfico em largura total dá ao gráfico o slide inteiro. Os diagramas que o próprio assistente desenha são verificados quanto a rótulos minúsculos.

Uma verificação de layout após cada mudança. Depois que o assistente muda slides, o Conduit olha como eles ficam. Se o texto sai do slide, se sobrepõe, encosta na nota de rodapé ou um diagrama fica ilegível, o assistente tem uma rodada para corrigir exatamente isso; o que sobrar é mostrado a você como uma nota. O texto que você mesmo escreveu nunca é alterado por ela. A verificação pega esses problemas; ela não garante um slide bem projetado.

Roteiro mostra cada palavra da apresentação como um único documento; digite ali, ou dê dois cliques no texto de um slide. O texto que você escreve é mantido quando o assistente reescreve um slide, a menos que você peça para mudar justamente esse texto. Histórico guarda uma versão para cada mudança, com o nome do seu pedido, para restaurar quando quiser. Há dois temas embutidos, além de qualquer tema que o assistente desenhe para você.

Apresentar abre a apresentação em tela cheia, com um modo apresentador separado — slide atual e próximo, notas do orador e um cronômetro — para manter privado enquanto você compartilha os slides. Exportar salva um único arquivo HTML que se apresenta sozinho em qualquer navegador, ou um PDF somente no Windows. Slides acrescenta dados ao seu banco de dados local: voltar a uma versão anterior aos Slides começa com um banco vazio (o arquivo antigo é mantido como backup).

Planilhas

Peça um orçamento, uma lista de preços, uma calculadora de empréstimo ou qualquer tabela que precise fechar, e o Conduit monta uma planilha de verdade que abre ao lado do chat. O assistente não digita números que ele mesmo calculou: ele escreve fórmulas, e o Conduit as calcula. Formatos de número, moeda, porcentagem e data, várias abas, linhas de cabeçalho congeladas e estilos para cabeçalhos, entradas e totais fazem parte da planilha. Quando uma fórmula falha, o assistente vê o erro (#NAME?, #REF!) na hora e corrige.

Mude pedindo. Como uma apresentação, é uma única planilha: "adicione uma linha para a auditoria de segurança", "coloque a coluna C em euros" ou "adicione uma aba com a hospedagem mensal" edita essa planilha em vez de criar outra. Uma linha nova herda os formatos e as fórmulas da linha de cima, e um total que termina logo acima cresce para incluí-la. Os valores ficam na moeda que você pedir. A grade é para leitura: clique em uma célula, ou ande com as setas, para ver a fórmula dela na barra de fórmulas, e troque de aba pelas guias embaixo.

Excel na entrada e na saída. Salvar como Excel (.xlsx)… no menu do painel grava um arquivo que abre no Excel, no Numbers ou no Google Planilhas, com as fórmulas e seus valores calculados. No sentido contrário, anexe um arquivo .xlsx a um chat, ou adicione-o a Documentos, e o modelo lê as abas como tabelas. O painel mostra os números do jeito que o idioma do app escreve, por exemplo 6.000,00 em português e 6,000.00 em inglês.

Pesquisa

Para uma pergunta que exige mais do que uma busca rápida, ative a Pesquisa no menu + do composer (ou escolha-a em Início) e pergunte. Ela exige que a busca web esteja ativada e não está disponível no modo somente local. A Pesquisa usa um backend de busca local (Exa, Tavily, Brave, seu próprio SearXNG ou DuckDuckGo), nunca a busca hospedada: as consultas vão para esse serviço e o texto das páginas vai para o provedor de chat que você escolheu.

O resumo. Antes de qualquer coisa rodar, a Pesquisa propõe um resumo: de uma a seis subperguntas que vai responder, um escopo opcional e uma profundidade. Você edita e aprova. Cada profundidade define até onde ela pode ir:

O que ela lê. Lê as páginas inteiras, três por vez: páginas web e PDFs de até 20 MB, processados no seu dispositivo. Um PDF escaneado não tem texto e conta como uma página sem conteúdo. Em uma página ou PDF longo, o modelo vê o início e as partes que combinam com as suas perguntas, não o todo.

A verificação das citações. O modelo extrai afirmações, cada uma com as palavras exatas da página que a sustentam. Uma afirmação só conta se a citação (de pelo menos 20 caracteres) estiver no texto guardado dessa página, e essa verificação é feita pelo app, não pelo modelo. Depois a Pesquisa busca de novo o que ainda está sem resposta, e um redator transforma as afirmações verificadas no relatório. As citações numeradas e a lista de fontes são geradas pelo app, não pelo modelo.

A credibilidade das fontes. Cada página recebe uma avaliação de credibilidade. Uma fonte fraca é marcada nas fontes do relatório, e as afirmações dela são atribuídas a ela (“um preprint não revisado afirma…”) ou deixadas de fora, nunca apresentadas como fato estabelecido. Sites oficiais, de órgãos públicos e de universidades nunca recebem avaliação baixa. A avaliação é o julgamento do modelo; a verificação das citações acima é feita pelo app.

A etapa de revisão. Antes de o relatório ficar pronto, uma etapa de revisão confere cada frase com os fatos que ela cita e com o restante do relatório, e corrige ou remove o que eles não sustentam. A Pesquisa sabe a data de hoje, então “atual” significa agora e eventos anteriores são lidos como passado. Números que diferem por ano, edição, definição ou unidade são explicados em vez de apresentados como uma discordância, e uma subpergunta que ela não conseguiu responder cita os sites cujas páginas não puderam ser lidas.

O relatório. O resultado é um documento Markdown nos documentos do chat: um resumo, achados por subpergunta, perguntas em aberto e fontes numeradas, com cada achado citado. O cartão no chat mostra o resumo e quantas fontes foram citadas e lidas, com um botão Abrir o relatório. Parar encerra a execução e mantém o que foi encontrado até então.

As páginas não podem dar ordens a ela. O texto das páginas só chega a uma chamada ao modelo sem ferramentas, então uma página que tente dar instruções não consegue fazer a Pesquisa buscar, baixar nem salvar nada. As chamadas ao modelo da Pesquisa rodam em uma conversa oculta própria.

Limites: em uma página longa, o modelo vê um trecho, não tudo. Um PDF escaneado não tem texto. Seus próprios documentos ainda não são uma fonte. Um modelo de raciocínio é lento, e a profundidade Profunda pode atingir o limite de tempo antes de terminar.

Escrita

Escrita, na barra de navegação (Ctrl+5, ⌘5 no macOS), serve para textos longos: posts de blog, documentação técnica, relatórios, newsletters, ensaios. Abra-a pela barra, pelo bloco Escrita em Início ou pelo chip Escrever na caixa de texto de Início, e descreva o que você está escrevendo.

Primeiro o esboço. O assistente propõe um esboço: as seções, o que cada uma precisa dizer e uma extensão-alvo. Você edita, adiciona, remove ou reordena seções e o aprova. Depois ele escreve o rascunho seção por seção em um editor Markdown ao lado do chat; cada seção aparece à medida que é escrita, e o rascunho continua até que todas as seções do esboço tenham texto.

Fontes. Na aba Fontes, um rascunho pode pesquisar coisas na web (desligado por padrão), recorrer às suas coleções de Documentos ou partir de um relatório de Pesquisa concluído, cujos fatos verificados por citação ele prefere. Um cartão de Pesquisa concluída em um chat tem Escrever a partir deste relatório. Os fatos de uma fonte são vinculados no rascunho, e o assistente é instruído a marcar com [TODO] tudo o que não tiver uma em vez de inventar.

O que você escreve continua seu. Qualquer parágrafo que você digitar ou mudar é marcado como seu, e o assistente o mantém palavra por palavra, a menos que você peça para mudar esse texto; Deixar a IA editar o devolve a ele. Peça uma mudança no chat e só aquela parte é reescrita. Selecione texto para Reescrever, Mais curto, Mais longo, Mais claro, Corrigir gramática ou dar a sua própria instrução. Mostrar texto da IA destaca com uma cor os parágrafos que o assistente escreveu e que ninguém editou ainda.

Histórico guarda uma versão depois de cada mudança do assistente e depois da sua própria edição, e restaura qualquer uma delas. Exportar salva o rascunho como arquivo Markdown ou HTML; um rascunho que tem links para páginas web termina com uma lista de fontes com elas.

Limites: as buscas na web exigem que a busca web esteja ativada e não estão disponíveis no modo somente local. Só um relatório de Pesquisa concluído pode ser uma fonte. Ao contrário da Pesquisa, o app não verifica os fatos de um rascunho contra as fontes: os links e as marcas [TODO] são trabalho do modelo, então confira-os antes de publicar. A exportação é só em Markdown ou HTML.

Fluxos de trabalho

A página Fluxos de trabalho executa rotinas por você. As etapas buscam páginas, pesquisam na web, executam uma pesquisa aprofundada, buscam nos seus Documentos, leem arquivos da pasta própria do fluxo, transformam CSV ou JSON em tabela, chamam ferramentas somente de leitura dos seus conectores, pedem ao modelo que resuma e fazem uma pergunta a você. O resultado pode ser salvo como documento, alterar uma apresentação do Slides ou um rascunho do Escrita, ser exportado como arquivo (Markdown, texto, CSV, JSON ou HTML) ou ser sugerido como memória — uma etapa "Salvar na memória" apenas sugere e nunca adiciona nada por conta própria. Comece por um fluxo pronto — um briefing da manhã, um monitoramento de página, um resumo semanal de pesquisa, uma apresentação semanal de números — ou crie o seu no editor de etapas. Abra qualquer execução para ver o que cada etapa fez e qual modelo usou; se você corrigir uma etapa, execute novamente a partir dela, sem repetir as anteriores.

Ou apenas descreva. Diga o que você quer com suas próprias palavras, na página de fluxos de trabalho ou com o chip Automatizar do Início, e o modelo do chat redige um fluxo, confere e corrige o que não bate. Ele abre no editor sem ser salvo, com uma lista curta do que falta você escolher, como a pasta ou a apresentação; nada é salvo nem agendado até você dizer. Salvar chat como fluxo de trabalho, na paleta de comandos, transforma o que você fez em um chat em um fluxo que você pode executar de novo; ele vê suas mensagens e quais ferramentas foram usadas, não as páginas nem os documentos em si. Um fluxo pode usar o próprio modelo, e cada etapa de resumo ou de agente pode substituí-lo: um modelo rápido e barato para a maior parte do trabalho e um mais forte para o texto final, ou um modelo local para etapas que tocam dados privados. Um fluxo sem modelo escolhido segue o do chat.

Execute quando importa. Execute agora, em um agendamento (diariamente, em dias úteis em um horário fixo, ou a cada poucas horas) ou automaticamente quando uma nova publicação aparecer em um feed RSS ou Atom ou um novo arquivo chegar à sua pasta: ative Executar automaticamente, e cada nova publicação ou arquivo ganha a própria execução. Uma etapa "Continuar somente se…" encerra uma execução em silêncio quando um valor não mudou, está vazio ou não contém certo texto, e as etapas de notificar e salvar podem se pular quando o que enviariam ou salvariam é igual ao da vez anterior — assim, uma execução agendada que não encontra nada novo não envia notificação. Se um feed ou uma pasta não puder ser lido três vezes seguidas, você recebe uma notificação, e o fluxo continua sozinho quando voltar a ler.

Ao ligar as execuções automáticas, primeiro é listado tudo o que o fluxo poderá fazer sozinho — os sites que ele lê, a busca na web, as pastas que ele lê, os conectores, qual modelo e qual provedor, o salvamento de documentos — para você aprovar. Uma execução que precise de mais, depois de uma edição por exemplo, pausa e pergunta: permitir uma vez, sempre permitir ou não permitir. Uma ferramenta de conector que apenas lê roda sozinha; uma que envia, publica ou altera algo pausa a execução e pergunta (veja Ações externas abaixo). As atualizações de uma apresentação ou de um rascunho nunca alteram texto que você mesmo escreveu, e uma versão é guardada antes e depois, de modo que "Desfazer esta atualização", na execução, ou o Histórico a restaura. Cada execução tem um limite de tempo e de tokens, e você pode interromper uma em andamento. Uma execução perdida enquanto o Conduit estava fechado acontece uma vez quando você o abre.

Para que os agendamentos continuem com a janela fechada, o Conduit pode ficar na bandeja do sistema e iniciar lá quando você entra; as duas opções vêm desligadas por padrão, e a da bandeja é oferecida uma única vez, na primeira vez que você liga um agendamento.

Veja e molde como uma tela. Um fluxo de trabalho aberto mostra suas etapas como uma tela ou como uma lista, e o Conduit lembra a sua escolha. A tela desenha o início, cada etapa, os laços e as linhas entre eles; durante uma execução, cada etapa mostra se está rodando, concluída, com falha, ignorada ou esperando por você, e um laço conta seus itens. Selecione uma etapa para ver a entrada e a saída dela em uma execução. Para editar, adicione etapas a partir de uma paleta, arraste-as para reordenar ou para dentro de um laço e arraste um fio de uma etapa a outra para escolher qual saída entra em qual campo. As etapas com problemas ficam marcadas, e sair com alterações não salvas pergunta antes. Um fluxo de trabalho tem as abas Etapas, Execuções e Resultados. Toda execução concluída guarda o que salvou, com uma prévia; a aba Resultados as lista, uma lista Resultados na barra lateral de Fluxos de trabalho cobre todos os fluxos e marca os não lidos, e Início mostra Novidades dos seus fluxos de trabalho.

Ramificações e etapas lado a lado. Uma etapa Se… senão leva a execução por um caminho de sim ou de não, e o caminho não seguido é registrado como Não seguido. Uma etapa pode esperar por quaisquer etapas anteriores, então as etapas que não dependem umas das outras rodam lado a lado, até quatro ao mesmo tempo, e uma etapa posterior pode reuni-las; Roda depois de, em cada etapa, faz o mesmo sem arrastar. Os fluxos de trabalho salvos antes disso rodavam em ordem e continuam assim. Um fluxo de trabalho também pode começar quando uma ferramenta de listagem somente leitura de um conector devolve algo novo, verificada de 15 em 15 minutos até uma vez por dia: cada item que ela ainda não tinha visto inicia uma execução.

Ações externas. Quando uma etapa quer usar uma ferramenta de conector que envia, publica ou altera algo, a execução pausa e mostra a chamada exata. Escolha Enviar, Editar e depois enviar, ou Não enviar, que interrompe a execução com um motivo. Não perguntar de novo sobre isso neste workflow permite essa ação daí em diante. No painel Início, Ações externas liga ou desliga a pergunta para o fluxo de trabalho (ligada por padrão) e lista as ações permitidas sem perguntar, cada uma removível. As ferramentas que um conector marca como sensíveis sempre perguntam, e as aprovações que você mantém no chat não valem para os fluxos de trabalho. Uma etapa de agente pode usar até dez ferramentas de conector e não pode chamar uma que a etapa não liste.

Agentes e ajudantes. Um fluxo de trabalho pode definir ajudantes, cada um com suas próprias instruções, modelo, ferramentas e limite de tokens. Uma etapa de agente nomeia os ajudantes a quem pode passar trabalho, escreve uma tarefa para cada um e recebe a resposta de volta. Um ajudante pode passar trabalho adiante em mais um nível, no máximo, ciclos de ajudantes são recusados ao salvar, e uma etapa distribui no máximo doze tarefas. Os ajudantes precisam das mesmas aprovações que uma etapa precisaria. A página Agentes mostra um cartão para cada etapa de agente e cada ajudante: se está trabalhando, o modelo, as ferramentas, se usa o seu computador, as passagens de trabalho e as tarefas, falhas e tokens dos últimos 30 dias, com busca e os filtros Todos, Trabalhando e Ajudantes. Descrever um fluxo de trabalho agora pode redigir ramificações, etapas lado a lado, etapas de conector e ajudantes; tudo o que o modelo inventar, como um conector que você não tem, é removido e anotado.

Agentes que usam o seu computador. Isto fica desligado até você ativar Configurações → Computador, que também guarda as regras que sempre perguntam. Um fluxo de trabalho ativa por etapa de agente ou ajudante com Usar o computador e precisa indicar uma pasta. O agente pode então executar comandos (um programa com argumentos, nunca uma linha de shell), listar, ler e pesquisar arquivos e gravar ou editar arquivos nessa pasta. Todo comando pergunta antes, a menos que uma das regras de permissão do fluxo de trabalho o cubra, como git status *; o cartão de aprovação oferece a regra mais estreita em Executar e permitir …. Alguns comandos sempre perguntam, quaisquer que sejam as regras: apagar arquivos, git reset --hard, git clean, push forçado, ferramentas de sistema e de segurança, shells e comandos longos ou incomuns, além das suas próprias regras de recusa. Os comandos arriscados ganham um cartão próprio, com Não executar como botão principal. Depois que um agente lê conteúdo externo, como uma página web, uma busca ou o resultado de um conector, as regras de permissão deixam de cobrir os comandos dele no resto dessa execução, e o cartão diz por quê. As alterações de arquivo mostram um diff de linhas e perguntam antes, a menos que você deixe o fluxo de trabalho alterar arquivos livremente na pasta dele. A aba Permissões de cada fluxo de trabalho lista as regras de comando e quantas vezes cada uma foi usada, a lista integrada de comandos que sempre perguntam e as regras sugeridas a partir dos comandos que você aprovou nas últimas dez execuções. Os detalhes da execução listam cada comando e cada alteração de arquivo, quem aprovou, o código de saída e a saída.

Limites: no Windows, os comandos também ficam impedidos de gravar fora da pasta, com o tráfego de rede reduzido a quase nada; um fluxo de trabalho pode desligar isso para programas que não funcionam assim. O macOS e o Linux não têm esse confinamento, então as suas aprovações são o único controle ali.

A Caixa de entrada e as execuções que esperam. A Caixa de entrada lista tudo o que seus fluxos de trabalho estão esperando: perguntas, revisões, ações externas e aprovações de comandos. A barra de navegação mostra um ponto quando algo está esperando, e novos pedidos geram uma notificação do sistema. Uma execução pausada por você continua depois que você fecha e reabre o Conduit, com o prazo original; as etapas já concluídas não rodam de novo e uma ação já enviada não é enviada duas vezes, e uma execução cujo fluxo de trabalho mudou enquanto esperava é interrompida e avisa. O tempo de espera não conta para o limite de tempo da execução.

Início

O Conduit abre em Início, o primeiro item da barra de navegação. Uma única caixa de texto começa qualquer coisa: peça uma apresentação e Slides abre com uma narrativa; peça qualquer outra coisa e um chat começa. Abaixo, Precisa de você lista aprovações e perguntas de fluxos de trabalho e sugestões de memória à sua espera (oculto quando não há nada), Novidades dos seus fluxos de trabalho mostra os resultados que você ainda não abriu, Continue de onde parou mostra seus últimos chats, apresentações, rascunhos e apps, e cada área do app tem um bloco com contagem ao vivo — ou um exemplo para experimentar enquanto estiver vazia.

Ctrl+1 a Ctrl+9 (⌘ no macOS) abrem Início, Chats, Slides, Escrita, Apps, Fluxos de trabalho, Caixa de entrada, Agentes e Contexto. Gerenciar não tem número; acesse-o pela barra de navegação, por Início ou pela paleta de comandos, que tem uma entrada “Ir para” para cada área.

Aparência e idioma

O Conduit tem um único design em dois modos. Em Configurações → Aparência, escolha escuro, claro ou seguindo o seu sistema, e escolha a cor principal — o destaque em botões, seleção e no item ativo — separadamente para cada modo; uma cor que seria difícil de ler é recusada. A mesma página define o tamanho da fonte da interface, a densidade e o tamanho dos diagramas.

A mesma página de Configurações define o idioma da interface, nos oito idiomas em que o Conduit é distribuído. Ela muda menus, botões, datas e números — não muda o idioma em que o assistente responde.

Onde seus dados ficam

O Conduit guarda tudo no diretório de dados de aplicativo da sua plataforma: um banco SQLite para conversas, mensagens, prompts e uso, mais um blob store endereçado por conteúdo para anexos e artefatos, deduplicados por hash.

As mensagens são gravadas como um log de eventos append-only com uma view materializada por cima, o que permite que uma conversa sobreviva mesmo se o app for encerrado no meio de uma resposta. Na inicialização, o Conduit reconcilia os dois.

A criptografia opcional AES-256-GCM em repouso está disponível em Settings → Privacy & data, com a chave mestra encapsulada pelo chaveiro do seu sistema operacional. Ela vem desligada por padrão e ainda não cobre o texto das mensagens. Veja a página de privacidade para o escopo atual.

Solução de problemas

O build falha no Windows

Quase sempre é a falta da toolchain de C++. Instale o Visual Studio 2022 Build Tools com a workload "Desktop development with C++" e depois rode check-setup.ps1 para confirmar.

A minha chave de provedor não está sendo salva

O Conduit precisa de um cofre de credenciais do sistema operacional funcionando. Em sistemas Linux headless ou mínimos pode não haver nenhum Secret Service em execução. Inicie um daemon de keyring ou ative o armazenamento de credenciais criptografado baseado em arquivo, que exige fornecer uma chave pelo ambiente.

Os modelos do Ollama não aparecem

Confirme que o Ollama está rodando, que pelo menos um modelo foi baixado e que a base URL configurada no Conduit corresponde à porta em que o Ollama está escutando.

Outra coisa está quebrada

Exporte um pacote de diagnóstico em Settings → Diagnostics e anexe a uma issue. Ele exclui segredos, base URLs, allowlists e o conteúdo das conversas por design, e exige que você reconheça o que ele contém antes de ser gerado.

Ler o código