Perguntas frequentes sobre o Volath

O Volath é um painel local que leva um ticket da ideia ao código integrado, com a IA a fazer o trabalho de desenvolvimento. Escreve um ticket, um agente de IA analisa-o, escreve o código no seu repositório git, abre um pull request, corrige falhas de CI e comentários de revisão, faz o deploy para staging e corre um teste real no navegador.

O workflow por omissão tem To Do, Analyzing, Not Ready, Ready, In Development, Development Done, Waiting for CI, Code Review, On Staging, On Testing, Awaiting Merge e Done. Depois da análise, um ticket fica Not Ready ou Ready. A coluna Done fica escondida no quadro por omissão, cada projeto pode mudar os passos em Workflows e os nomes dos estados aparecem em inglês na aplicação.

Sim. O desenvolvimento com IA inclui a correção automática do CI e a resposta aos comentários de revisão, depois de a IA abrir o pull request.

Depois de um deploy para staging, o Playwright conduz um navegador contra o ambiente e guarda capturas de ecrã. O Volath descarrega o navegador Chromium de que precisa na primeira vez que corre um teste real.

Sim. No Project Planner, no menu Tools, descreve um projeto e junta documentos. A IA cria o projeto com os seus tickets e subtarefas, todos deixados em To Do.

Um agente é uma função com as suas próprias instruções e, opcionalmente, o seu próprio modelo. Uma skill é um guia reutilizável, como uma lista de verificação de revisão, que associa a um agente ou a um ticket. Uma squad é um agente líder com membros: o líder entrega cada passo ao membro certo, um de cada vez.

Sim. A Memory guarda lições por projeto com tickets integrados, pull requests rejeitados e comentários de revisão. As lições ativas são acrescentadas aos prompts de análise e de desenvolvimento. Pode rever, editar ou apagar as lições e desligar a aprendizagem por projeto e por ticket.

Erros do New Relic, problemas do SonarCloud, alertas do Dependabot e a saúde dos pacotes Composer e NPM: desatualizados, atualizações maiores, vulneráveis, obsoletos e utilização. Cada descoberta pode tornar-se um ticket.

Sim. A sincronização com gestores de tarefas importa tickets do Jira, do Linear ou dos GitHub Issues e escreve o progresso de volta por passo.

Um computador com Windows, macOS ou Linux, o Git no PATH, pelo menos um fornecedor de IA e um token do seu serviço Git. Não é preciso instalar mais nada: o instalador traz o que o próprio Volath precisa. O Chromium para os testes reais é opcional e o Volath descarrega-o na primeira vez que corre um teste real.

GitHub, GitLab (incluindo instalações próprias) e Bitbucket Cloud. Escolhe o serviço por projeto em Settings › Git host, com um token que consiga aceder aos repositórios em que trabalha.

Transfira o instalador para o seu sistema na página de transferência e abra o Volath. O assistente de configuração pede a sua chave de licença, cria o administrador, deixa-o escolher a IA e adicionar o primeiro projeto. Depois crie um ticket a partir do Board.

Sim, se quiser trabalhar no próprio Volath ou ler o código: o guia para executar a partir do código lista os comandos. Para o uso diário o instalador é o caminho, porque atualiza-se sem complicações e não precisa de Node.js na sua máquina.

Claude Code, Codex, GitHub Copilot e OpenCode como CLIs, e as APIs da Anthropic e da OpenAI. Precisa de pelo menos um: uma CLI (claude, codex, copilot, opencode) ou uma chave de API.

Sim. O fornecedor e o modelo são configuráveis globalmente, por projeto e por ticket. Um campo vazio no projeto usa o valor geral.

Sim. O SQLite é o padrão e não precisa de configuração. Para usar MySQL 8 ou mais recente, ou MariaDB, crie uma base de dados vazia e defina as variáveis VOLATH_DB_ em backend/.env. As migrações versionadas e a cópia automática antes de uma migração são só para SQLite, por isso faça uma cópia da base de dados MySQL com mysqldump antes de atualizar o Volath, e tenha em conta que os dados SQLite existentes não são transferidos.

Feche o Volath e apague a sua pasta de dados: %APPDATA%\Volath no Windows, ~/Library/Application Support/Volath no macOS, ~/.config/Volath no Linux. O Volath volta a arrancar com o assistente de configuração. Isto apaga a base de dados e as capturas de ecrã guardadas, por isso tickets, projetos, programadores, tokens de API e todas as definições são removidos, e não pode ser desfeito. Exporte antes uma cópia de segurança nas Settings se quiser guardar alguma coisa.

Sim. As colunas do quadro são os passos de um workflow que edita em Workflows, no menu da roda dentada. Um passo pode ser um passo simples, uma decisão, um passo em paralelo ou um portão, e cada passo pode correr ações como analisar, desenvolver, criar um pull request, verificar o CI, rever, correr testes, integrar ou fazer uma análise de segurança. Existe um workflow geral e cada projeto segue-o, a menos que tenha o seu. To Do e o passo final são fixos.

Sim. O Catalog em Workflows lista o Full pipeline, com CI, revisão de código, staging e testes antes de Done, e o Local, para um projeto sem repositório remoto e por isso sem pull requests, CI nem revisões. Lista também os workflows que guardar e os que os plugins publicarem. Usar um dá ao projeto a sua própria cópia, e os workflows podem ser exportados como JSON e importados noutro Volath.

Um plugin alarga o Volath com uma página sua, widgets do quadro, automatizações ou integrações, sem alterar o Volath. É um zip com um plugin.json que um administrador instala em Settings › Plugins. Um plugin declarativo não tem código e chama uma API HTTP ou uma função do Volath quando acontece um evento, e um plugin com código é um ficheiro Node que fala com o Volath através de ctx.

O código de um plugin corre num processo Node próprio, com o modelo de permissões do Node e sem nada do ambiente do Volath, e cada chamada é verificada contra as permissões que o administrador aceitou. Um plugin fica desligado até elas serem aceites e nunca pode apagar tickets nem projetos. O Node não consegue fechar a rede a um processo, no entanto, por isso instale código de plugins só de pessoas em quem confia. Os plugins declarativos não têm código.

Não. Qualquer plugin é um zip que pode instalar em Settings › Plugins. O marketplace é uma lista de plugins oficiais que pode instalar a partir da aplicação, e cada transferência tem de trazer um sha256 que corresponda à lista. Os administradores podem definir uma política marketplace only que recusa instalações por zip.

Sim. Em Settings › Plugins, Build with AI deixa-o descrever o plugin e copiar o prompt, juntamente com o guia completo do plugin, para uma conversa com uma IA. Verifique os ficheiros que ela devolve com a ferramenta do SDK e depois largue o zip. O SDK está no GitHub em volath/sdk.

Não. As chamadas que um plugin faz seguem o seu plano em cada chamada, por isso um plugin não pode usar uma funcionalidade que o seu plano não inclui, e um plano que termine ou mude tem efeito sem reinstalar o plugin. O marketplace não aceita plugins que reimplementem uma funcionalidade de um plano pago, e o ecrã de instalação avisa quando um plugin parece ser um desses.

Não. O Volath é software licenciado. Só o SDK de plugins (github.com/volath/sdk) e o marketplace de plugins (github.com/volath/marketplace) são públicos, com licença MIT.

Sim. O Volath é uma aplicação que instala e corre na sua própria máquina. O seu código, tickets e definições ficam numa base de dados SQLite local, no seu computador, por omissão, ou no seu próprio MySQL ou MariaDB.

Acompanha cada ticket num quadro Kanban. Em Project settings › Policies pode reter passos até um humano aprovar: antes de a IA começar a desenvolver, antes de o pull request ser aberto ou antes da integração em staging. Por omissão o pipeline corre sozinho e nada fica retido até ligar uma política.

Sim. Uma política pode deixar correr automaticamente apenas tickets com uma etiqueta como safe, e só enquanto o gasto de IA no ticket ficar abaixo de um limite.

O Volath corre agentes de IA com acesso de escrita à pasta do projeto e pode enviar branches e abrir pull requests com o seu token do GitHub. Use-o em repositórios em que confia e reveja os pull requests que ele abre.

Sim. Os webhooks enviam eventos como ticket.status_changed, pr.opened, ci.failed e deploy.finished num POST JSON, assinado com HMAC-SHA256 quando define um segredo. Defina Send as como Slack ou Teams para receber uma mensagem legível.

Sim. Junte o segredo de assinatura do Slack ou o token de segurança do Teams a um webhook para o tornar bidirecional: create, status, approve e reject funcionam a partir do chat, e as mensagens de aprovação do Slack ganham botões Approve e Reject.

Sim. A documentação da API está em /api/docs, no endereço do seu Volath local, em OpenAPI, gerada a partir dos decoradores do NestJS.