Como combinar código, design e texto em um workspace de IA — experimentando o Kun
Um fluxo de trabalho típico com assistentes de IA parece caótico. Um desenvolvedor copia um trecho de código do IDE para uma janela do navegador com o ChatGPT, pede para corrigir a lógica, cola o resultado de volta, executa os testes, vê um erro e corre de volta para a interface web. Se você adicionar tarefas de escrita de documentação ou esboço de protótipos de UI a isso, alternar entre abas se torna interminável.
Os desenvolvedores do projeto Kun decidiram combinar escrita de código, texto, design e automação em um único ambiente local. A principal característica da ferramenta é um runtime compartilhado que pode conectar simultaneamente uma interface gráfica e um terminal.
Um Runtime para Janela GUI e Console
O Kun é construído sobre um processo de servidor kun serve. Ele inicia na máquina local e assume o gerenciamento de sessões, históricos de tarefas, conexões com LLMs e execução de comandos.
Você pode iniciar o aplicativo desktop Electron e simultaneamente abrir um terminal na pasta do projeto digitando o comando:
kun
Ambas as interfaces capturam instantaneamente o mesmo contexto de trabalho. Precisa enviar rapidamente uma breve clarificação sem tirar as mãos do teclado — escreva no TUI. Quer visualizar diffs de arquivos, editar uma tela visual ou analisar um documento PDF com capturas de tela — mude para o GUI. Todas as alterações, plano de ação e histórico de chamadas de ferramentas permanecem sincronizados.
Cinco Workspaces para Diferentes Tarefas
Os autores não limitaram o projeto aos limites da "programação com IA" básica. O workspace é dividido em cinco blocos especializados.
- Código. Um modo completo para trabalhar com um repositório. O agente pode pesquisar em arquivos, fazer edições, executar comandos do console, rodar testes e exibir diffs de alterações internas.
- Escrever. Um ambiente para preparar documentação, artigos ou relatórios. Suporta conclusão e edição de texto inline e pode exportar resultados para Markdown, HTML, PDF, DOCX e PPTX.
- Design. Um modo para criar protótipos interativos em HTML/CSS e gerar arquivos de sistema de design (
DESIGN_SYSTEM.md). Uma interface esboçada pode ser passada imediatamente para o bloco de codificação.
- Pesquisa. Trabalhando com contexto multimodal. Você faz upload de arquivos PDF, gráficos ou capturas de tela, e o agente extrai fatos, reúne argumentos e gera anotações finais.
- Automatizar. Um módulo para executar tarefas em segundo plano. Aqui você configura agendamentos, loops de repetição, hooks e conecta ferramentas externas via MCP (Model Context Protocol).
Como o Agent Graph Funciona para Tarefas Complexas
Para perguntas rápidas ou edições direcionadas, o Kun tem um modo Direto — um diálogo rápido sem burocracia desnecessária. Mas se uma tarefa abrange dezenas de arquivos e requer verificação sequencial, o modo experimental Agent Graph entra em ação.
Neste modo, o agente principal (Lead Agent) primeiro constrói um grafo de dependências. Depois divide a tarefa em pequenas subtarefas e as delega para agentes filhos isolados. Cada agente filho recebe apenas as permissões, ferramentas e acesso a arquivos necessários para sua etapa.
O resultado do trabalho é passado adiante na cadeia somente após o Lead Agent verificar as alterações e confirmar que os testes passaram. Se ocorrer uma falha em qualquer etapa, o grafo não finge que tudo correu bem. Uma tarefa pode ser pausada, corrigida manualmente, ou um nó separado pode ser enviado para reexecução.
Dados Locais e Liberdade de Escolha de Modelos
O Kun é projetado com um princípio local-first. Todo o banco de dados de sessões, logs, configurações locais e arquivos do projeto são armazenados exclusivamente no seu disco.
Ao mesmo tempo, o projeto não exige que você use uma rede neural específica. Através de um menu de configurações unificado, você pode conectar virtualmente qualquer provedor:
- Modelos locais via Ollama
- APIs de nuvem da OpenAI, Anthropic, Gemini, DeepSeek, Qwen ou Kimi
- Qualquer serviço de terceiros compatível com OpenAI Chat Completions ou Anthropic Messages
Se você escolher um provedor de nuvem, os dados específicos da requisição e arquivos anexados serão enviados para os servidores deles. Isso vale a pena considerar ao trabalhar com código proprietário da empresa.
Como Implantar e Experimentar
Pacotes pré-construídos para macOS (Intel e Apple Silicon), Windows e Linux estão disponíveis na página de releases do projeto. Se você quiser executar o sistema a partir do código-fonte ou mexer no código do backend, será necessário Node.js versão 22.19 ou superior.
O processo de inicialização a partir do repositório é padrão:
git clone https://github.com/KunAgent/Kun.git
cd Kun
npm ci
npm run dev
Um comando especial é fornecido para iniciar o cliente de terminal separadamente:
npm run dev:tui
Após o primeiro lançamento, você só precisa configurar pelo menos uma chave de API ou modelo local no Ollama, após o que pode abrir o projeto desejado.
Vale a Pena Instalar
O Kun parece uma tentativa viável de reunir o conjunto disperso de ferramentas de um desenvolvedor em um único sistema gerenciável. A ideia de um runtime contínuo para TUI e GUI realmente elimina a necessidade de copiar contexto entre as janelas do console e do navegador.
Uma nuance a ser observada é a licença PolyForm Noncommercial 1.0.0. Para projetos pessoais, pesquisa e aprendizado, a ferramenta é completamente gratuita. No entanto, uso comercial ou incorporação em produtos pagos exigirá permissão separada dos autores. Dito isso, empresas podem solicitar permissão escrita gratuita para uso interno de funcionários enviando um e-mail para os desenvolvedores.
Projetos relacionados