DevPulse AI

Tutorial do DevPulse AI

Da instalação a cada tela do app, com capturas. Use o índice para ir direto ao que precisa.

1. Instalação

O DevPulse AI é distribuído como instalador para Windows e pacote .deb para Linux. Baixe na página de download — basta informar seu e-mail.

Windows

  1. Baixe DevPulse AI_0.1.4_x64-setup.exe (recomendado). O .msi é para instalação gerenciada por TI.
  2. Dê dois cliques no arquivo. Se aparecer “O Windows protegeu o computador”, clique em Mais informações → Executar assim mesmo (veja abaixo).
  3. Siga o assistente. Ao final, o DevPulse abre sozinho e passa a iniciar com o atalho do Menu Iniciar.

“O Windows protegeu o computador”? É o SmartScreen. Ele avisa sobre instaladores que ainda não têm assinatura digital paga ou que ainda são pouco baixados — o aviso não indica problema no arquivo. Clique em Mais informações; aparece o botão Executar assim mesmo. Antes disso, o navegador também pode avisar que o arquivo “não é baixado com frequência”: no Edge, abra o menu … do download → Manter → Mostrar mais → Manter assim mesmo; no Chrome, Manter. Para conferir que o arquivo é o original, compare o SHA-256 da página de download com o resultado de Get-FileHash "DevPulse AI_0.1.4_x64-setup.exe" no PowerShell.

Linux (Ubuntu, Debian, Mint, Pop!_OS)

No terminal, na pasta onde o arquivo foi baixado:

sudo apt install ./"DevPulse AI_0.1.4_amd64.deb"

O apt instala as dependências (WebKitGTK, GTK 3 e AppIndicator). Depois, abra DevPulse AI pelo menu de aplicativos.

Abriu o arquivo pela Central de Aplicativos? Ela mostra “Potencialmente inseguro — Este pacote é fornecido por terceiros”. O aviso aparece para qualquer .deb que não vem dos repositórios oficiais do Ubuntu (o mesmo acontece com Chrome, VS Code e Zoom) e não indica problema no arquivo. Você pode confirmar a instalação ali mesmo ou usar o comando acima, que não mostra o aviso. Para conferir que o arquivo é o original, compare o SHA-256 exibido na página de download com o resultado de sha256sum.

GNOME com Wayland: na primeira abertura, o sistema pergunta se o DevPulse pode registrar os atalhos globais Ctrl+Shift+D e Ctrl+Shift+P. Responda à janela — enquanto ela estiver aberta (às vezes atrás da mini-pill), o restante da tela não responde. Procure-a com Alt+Tab se não a vir.

Requisitos

  • Windows 10 ou 11, 64 bits (o WebView2 vem com o sistema ou é instalado pelo assistente).
  • Linux 64 bits com WebKitGTK 4.1 — Ubuntu 22.04+, Debian 12+ ou derivados.
  • Para os recursos de agente: Claude Code instalado e com login feito. Sem ele, o diff ao vivo, os gastos do proxy e as ferramentas continuam funcionando.

Atualizar

Faixa de nova versão no topo do DevPulse AI, com o botão Instalar e reiniciar
Versão nova disponível: a faixa no topo do painel.

A partir da versão 0.1.3 o DevPulse se atualiza sozinho. Ao abrir e a cada 6 horas ele consulta o site; quando há versão nova, aparece uma faixa no topo da janela com Instalar e reiniciar e uma notificação. O app baixa o instalador, confere a assinatura digital e reinicia já na versão nova; no Linux, o sistema pede a sua senha para instalar o pacote. Depois esconde a faixa até a próxima versão.

Em Configurações → Atualizações você procura na hora ou desliga a busca automática. Quem está numa versão anterior à 0.1.3 baixa a nova na página de download e instala por cima; dados e configurações são mantidos.

Desinstalar

No Windows, use Configurações → Aplicativos. No Linux, sudo apt remove dev-pulse-ai. Seus dados ficam em ~/.local/share/ai.devpulse.desktop (Linux) ou %APPDATA%\ai.devpulse.desktop (Windows) e podem ser apagados à mão — ou antes, pelo botão em Segurança.

2. Primeiro uso

Ao abrir, o DevPulse mostra a mini-pill no topo da tela e coloca o ícone na bandeja do sistema. O painel principal começa escondido: abra-o pelo botão de expandir da pill, pelo menu da bandeja ou com Ctrl+Shift+D.

Adicionar um projeto

  1. Abra o painel e vá em Código.
  2. Clique em Adicionar projeto e escolha a pasta do repositório.
  3. Pronto: a partir daí cada arquivo alterado na pasta aparece na lista, com o diff. Pastas como .git, node_modules e target são ignoradas, assim como o que estiver no seu .gitignore.

Conectar o Claude Code

Não há nada a configurar: o DevPulse lê os transcripts que o Claude Code já grava em ~/.claude/projects. Sessões, modelo, tokens, custo, contexto e a intenção declarada aparecem sozinhos em Agentes e na pill. Para importar o histórico, defina quantos dias ler em Configurações → Integrações.

Para aprovar edições antes da gravação, instale os hooks em Segurança e ligue o portão de aprovação.

Onde o app fica

  • Fechar (×) no painel não encerra o app: ele volta para a bandeja e a mini-pill reaparece.
  • Com o painel aberto, a pill flutuante se esconde e a mesma barra aparece encaixada no topo do painel.
  • Para sair de verdade, use Sair do DevPulse AI no menu da bandeja.

3. Mini-pill

A mini-pill é uma barra sempre visível com os números que importam enquanto o agente trabalha. Cada bloco é clicável e abre a seção correspondente do painel.

Mini-pill completa
Mini-pill completa: orçamento, burn rate, gastos, agentes, limites do plano e atividade de código.

O que cada anel mostra

BlocoO que significa
OrçamentoQuanto do orçamento ativo (de preferência o diário) já foi gasto. Fica amarelo ao passar do alerta e vermelho ao estourar. Sem orçamento, mostra o gasto do dia e o atalho Configurar.
Burn rateGasto por hora no ritmo atual e a diferença para a sua média dos últimos 7 dias. O anel enche quando o ritmo chega ao dobro da média.
Sessão atualCusto da sessão de agente que está trabalhando agora (ou a mais recente nas últimas 24 h). O anel mostra a fatia dela no gasto de hoje.
Opus · Sonnet · HaikuUm anel por modelo com o gasto de hoje e a fatia de cada um. Versões diferentes do mesmo modelo são somadas; outros modelos ganham anel próprio.
Todos os modelosTotal de hoje, somando todos os modelos e os ajustes de custo reportado.
AgentesSessões ativas sobre conhecidas (ex.: 2/3).
Sessão · Todos · Sonnet (limites)Limites do plano Claude: a janela de 5 horas, o limite semanal de todos os modelos e o semanal por modelo, com o horário de reset (↻). Amarelo a partir de 70%, vermelho a partir de 90%. Passe o mouse para ver o detalhe; clique para atualizar.
Atividade de códigoLinhas adicionadas e removidas na sessão; pulsa enquanto o agente escreve.
Botão vermelhoKill Switch: interrompe agentes cadastrados (aparece quando há algo para interromper).

Limites do plano exigem o Claude Code com login de uma assinatura (Pro/Max). O DevPulse só lê o token que o Claude Code já guarda e consulta a Anthropic a cada minuto, no máximo.

Versão compacta

O botão de compactar (ícone de setas para dentro) troca a pill por uma versão mínima com o gasto do dia, o percentual da sessão de 5 h e a atividade de código. O de expandir volta à completa. A escolha também fica em Configurações → Aparência.

Mini-pill compacta
Versão compacta.

Mover e encaixar

Arraste a pill por qualquer área vazia. Solte-a perto de uma borda da tela e ela encaixa nela; a posição é lembrada. Ctrl+Shift+P mostra ou esconde a pill.

4. Bandeja do sistema

Clique com o botão esquerdo no ícone da bandeja para abrir o resumo: gasto de hoje comparado a ontem, agentes das últimas 2 horas e arquivos recentes. Os três botões fazem:

  • Sanitizar — procura segredos e dados pessoais no texto da área de transferência e os substitui por marcadores (ex.: [REDACTED:ANTHROPIC_KEY]), pronto para colar num chat de IA.
  • Kill Switch — mesmo botão de emergência da pill.
  • Abrir painel — abre a janela principal.
Resumo da bandeja
Resumo aberto pelo ícone da bandeja.

O botão direito abre o menu: Abrir resumo, Abrir painel, Abrir Diff Inspector, Mostrar/ocultar mini-pill, Sobre o DevPulse AI… e Sair.

5. Painel principal

O painel tem a barra de título própria (com o estado geral — Tudo funcionando —, o sino de notificações e a conta), o menu lateral com as seções e, no topo do conteúdo, a mesma barra da mini-pill.

  • Ctrl+1 … Ctrl+9 e Ctrl+0 pulam direto para cada seção, na ordem do menu.
  • Ctrl+B recolhe o menu lateral para só os ícones.
  • O ponto ao lado do nome indica a saúde do app: verde, amarelo (alguma fonte degradada, como cotação desatualizada) ou vermelho. Passe o mouse para ver o motivo.

6. Visão geral

Visão geral
Visão geral: cartões do dia, gráfico de 30 dias, agentes, código, logs e ações rápidas.
  • Gasto hoje, Burn rate e Latência média (das chamadas pelo proxy), com a variação contra ontem e contra a média da semana. O ~ antes de um valor indica que ele é estimado pela tabela de preços.
  • Gastos por dia — últimos 30 dias com a linha do orçamento diário. O botão Tabela mostra os mesmos dados em linhas.
  • Agentes — sessões e seus estados (Executando, Ocioso, Aguardando aprovação, Em pausa, Erro) e o botão Parar tudo.
  • Atividade de código recente e Live logs — o que mudou e o que aconteceu, com links para as seções completas.
  • Ações rápidas — calcular tokens, sanitizar a área de transferência, gerar mensagem de commit e validar JSON contra um schema.

7. Código — Live Code Diff Inspector

O Diff Inspector mostra, em tempo real, cada arquivo que o agente (ou você) alterou desde o início da sessão.

Diff Inspector
Diff Inspector: projeto, sessão e resumo do agente no topo, arquivos e conversa à esquerda, diff à direita e as ações do projeto na sidebar principal.

Na linha do título ficam o projeto, a sessão (● indica sessão em andamento) e o botão +, que inicia uma sessão manual — útil para começar uma “fotografia” nova antes de pedir algo ao agente. Uma sessão termina sozinha depois de alguns minutos sem alterações (configurável). No canto direito, o resumo do agente: nome da sessão, estado, uso de contexto e total de linhas.

Enquanto o Diff Inspector está aberto, o grupo Projeto da sidebar principal traz Gerar commit, Portão de aprovação (o ponto verde no ícone indica ligado) e Adicionar projeto — também com a sidebar recolhida (Ctrl+B). Se o agente estiver mexendo direto no branch principal, aparece um aviso amarelo.

Lista de arquivos

Cada arquivo mostra o estado — Escrevendo (alterado nos últimos segundos), Modificado, Revisado, Revertido, além de Criado e Removido —, quem alterou (o agente da sessão ou outra origem), há quanto tempo e o total de linhas +/−. Quando o agente grava um arquivo, ele fica marcado na lista e o diff passa a mostrá-lo.

Visualizar o diff

  • Referência: compare com a baseline da sessão (como o arquivo estava quando a sessão começou) ou com o HEAD (último commit).
  • Unificado ou Lado a lado, com realce de sintaxe e numeração das duas versões.
  • Marcar como revisado (R) para controlar o que você já leu.
  • Abrir no editor leva à linha certa usando o comando configurado (ex.: code --goto {file}:{line}).

Reverter

Você pode desfazer um trecho (botão em cada bloco do diff), o arquivo inteiro ou a sessão toda (link acima da lista). O DevPulse restaura o conteúdo do início da sessão — alterações feitas antes dela são preservadas — e confere se o arquivo não mudou enquanto você decidia. Arquivos criados na sessão só são apagados se você confirmar.

Portão de aprovação

Com os hooks do Claude Code instalados e o portão ligado, cada edição proposta pelo agente para antes de ser gravada e aparece na fila Aguardando aprovação, com o diff do que vai mudar.

Edição aguardando aprovação
Uma edição aguardando aprovação, com o tempo restante para a resposta automática.
AçãoAtalhoO que acontece
Aceitar alteraçãoCtrl+EnterLibera a gravação. Com várias na fila, há também Aceitar todas da fila.
Pedir ajusteCtrl+IAbre um campo para dizer o que mudar (ex.: “use anyhow em vez de unwrap”); o agente recebe o comentário e tenta de novo.
RejeitarCtrl+⌫Descarta a edição; o agente é avisado.
Abortar sessão—Nega e interrompe o agente até você mandar uma nova mensagem.

Se você não responder em 5 minutos (300 s, configurável), o agente segue o fluxo normal dele. Se o DevPulse estiver fechado, o Claude Code também segue normalmente — os hooks nunca travam o seu trabalho.

Regras do portão

Aprovar cada edição cansa — e aprovação no automático não protege nada. Em Regras do portão (sidebar principal, grupo Projeto), escolha onde vale parar. São três opções, por projeto, que você combina como quiser:

  • Sempre pedir aprovação — pastas e tipos de arquivo sensíveis, como migrations/, infra/, .env* ou *.sql.
  • Liberar sem perguntar — o que não precisa de revisão antes de gravar, como tests/, docs/ ou *.md.
  • Tamanho mínimo do diff — edições com menos linhas alteradas (adicionadas + removidas) passam direto. 0 pede em qualquer tamanho.
Regras do portão
Regras do portão: sempre pedir, liberar sem perguntar e tamanho mínimo do diff.

Os padrões usam a sintaxe do .gitignore, um por linha: migrations/ vale para a pasta em qualquer nível e src/**/schema.rs para um caminho específico. Os botões de sugestão acrescentam os padrões mais comuns com um clique.

Ordem: “Sempre pedir” vence “Liberar”, que vence o tamanho. Sem nenhuma regra, o portão para em toda edição. O que passa direto aparece no log (“passou direto”) e continua no Diff Inspector, de onde pode ser revertido. Quando o projeto tem regras, o ícone de Regras do portão fica roxo.

Chat com o agente

Abaixo da lista fica a conversa da sessão — inclusive o que você digitou no terminal. Escreva na caixa e pressione Enter para mandar uma mensagem para a mesma sessão (Shift+Enter quebra a linha). Tabelas em markdown aparecem formatadas, e as linhas do próprio Claude Code também: o fim de cada resposta (“Concluído em 1m 12s · 1 shell ainda rodando”), tarefas em segundo plano concluídas, o resumo ao voltar e mensagens enviadas enquanto o agente trabalhava.

Enquanto o agente trabalha — mesmo num pedido feito pelo terminal —, aparece Processando… com a ferramenta em execução e o tempo decorrido, como no terminal.

Quando uma mensagem enviada daqui precisa de permissão (instalar pacote, acessar a rede, rodar um comando fora do projeto…), o pedido aparece no próprio chat, com notificação: Permitir uma vez, Permitir nesta conversa ou Negar. Sem resposta em 5 minutos, a ação é negada e o agente segue. Uma edição parada no portão de aprovação também aparece ali, com Aceitar e Rejeitar.

Os pedidos de permissão feitos no terminal também aparecem no chat da sessão: responda no terminal ou no DevPulse — Sim, Sim, e não perguntar de novo ou Não —, e quem responder primeiro decide; o outro lado se atualiza sozinho.

Ctrl+M (ou o botão de expandir ao lado de enviar) abre a conversa num painel inferior em toda a largura da janela, como o terminal do VS Code; a barra de status continua no rodapé, abaixo dele. Arraste a borda de cima para mudar a altura (ela é lembrada); o botão ▲ ou um duplo clique na borda maximiza o painel. Ctrl+M, Esc ou o × devolvem a conversa à sidebar.

Chat no painel inferior
Conversa no painel inferior, aberta com Ctrl+M.

Sessão aberta em outro terminal? Para não misturar dois históricos, o DevPulse não escreve numa sessão que está em uso em outro lugar e oferece abrir uma Nova conversa neste projeto. Edições pedidas pelo chat são aplicadas direto e aparecem no diff.

Gerar commit

Gera uma mensagem a partir do diff: usa o que estiver no índice (staged) ou, se não houver nada, as alterações não commitadas. A versão local segue a convenção configurada (ex.: Conventional Commits); a opção com IA envia o diff à Anthropic com a sua chave. Revise, edite e confirme para criar o commit.

Gerar commit
Mensagem de commit sugerida a partir do diff.

Atalhos do Diff Inspector

J/K (ou setas) próximo/anterior arquivo · N/P próximo/anterior trecho · R marcar como revisado.

8. Fluxos com Personas

Um time de personas leva a tarefa do entendimento ao commit: a Helena (analista) entende e tira dúvidas, os devs da linguagem do projeto desenvolvem com testes, o Rui revisa (a Vera entra em segurança e a Dora em banco quando precisa), a Bia faz os testes finais e você aprova. Cada etapa passa para a próxima um bastão com o trabalho feito. Você entra só nas decisões que são suas. Recurso do plano Pro, liberado na degustação (selo Pro · degustação), sem data de término.

Painel dos Fluxos com Personas
Painel: fila de tarefas à esquerda, grafo da tarefa seguindo o bastão no centro, pendências e detalhes à direita, linha do tempo embaixo.

Precisa do Claude Code instalado. Cada persona roda como uma sessão claude -p numa worktree do git própria da tarefa — o seu repositório principal não muda até você decidir. Push nunca: fica com você.

Painel

À esquerda fica a fila, em quatro grupos: Em andamento, Na fila, Homologação e Terminadas. Cada tarefa mostra a situação, quem está trabalhando agora, o progresso, o custo em R$, o modo de commit e, quando for o caso, o número de pendências, apontamentos abertos e o aviso fluxo alterado (troca de persona ou revisor que entrou no caminho).

No centro, o grafo mostra cada etapa: azul rodando, roxo com dúvida, âmbar sua vez, verde concluído, vermelho reprovado. As ligações percorridas ficam sólidas e a que está levando o bastão, animada. Seguindo o bastão, a câmera enquadra quem está trabalhando ou esperando você; mover ou dar zoom desliga, e Voltar a seguir retoma. Clique num nó para ver, à direita, o Resumo (rodadas, chapéu, custo e a pendência dele), o Bastão recebido e enviado em cada rodada e o Log. Sem nó escolhido, a direita mostra o resumo da tarefa: fluxo, branch, worktree, custo, lados e critérios de aceite.

No topo ficam o tempo da tarefa escolhida, quantas rodam, as pendências, as concluídas, o custo do dia, os ciclos por tarefa e os escapes da homologação, o botão Lições, quantas tarefas rodam em paralelo, o teto por tarefa e Pausar fila. Embaixo, a linha do tempo registra decisões, pendências, commits, avisos e a homologação de todas as tarefas (ou só da escolhida).

Nova tarefa

Escolha o projeto (repositório git), dê chave e título, cole o texto da tarefa e escolha o fluxo (ex.: Sprint do dia a dia ou Correção de bug). Defina o commit (manual ou automático) e o início: Manual (eu dou o start) deixa a tarefa na fila até você clicar em Iniciar; Automático pela fila começa sozinho quando abrir vaga. Na primeira vez, confira os comandos do projeto (testar, cobertura, lint, build, subir app): o DevPulse sugere pelos arquivos do repositório e eles rodam sem pedir permissão. Embaixo aparece a estimativa de custo pelas tarefas anteriores com o mesmo fluxo. O texto da tarefa é tratado como dado: instruções escritas nele não mudam as regras.

Nova tarefa
Nova tarefa: projeto, chave, título, texto, fluxo, commit, início e comandos do projeto.

Importar sprint

Se o projeto já tem o planejamento em Markdown (PRD, roadmap, sprints), Importar sprint lê os arquivos e coloca as tarefas de uma sprint na fila de uma vez. Tarefas são reconhecidas por títulos ou linhas de tabela que começam pela chave (ex.: ### API-001 — Estrutura do projeto), com o texto no primeiro bloco de código da seção. O dev de cada lado sai da stack do PRD (Python e FastAPI escalam o Caio; React, a Lara); Vera e Dora entram pela coluna de personas extras ou pelo assunto da tarefa. Fluxo, modo de commit e comandos do projeto também são lidos do documento, quando estão lá.

As dependências da tabela viram ordem na fila: a tarefa dependente espera a outra terminar com commit e já começa com o código dela. Antes de confirmar, escolha as tarefas, veja o fluxo sugerido de cada uma e troque o dev, ligue ou desligue revisores. Tarefa que já está no DevPulse vem travada (nada de duplicata); uma parada com a mesma chave volta para a fila. Dá para importar várias sprints, uma por vez, e as dependências entre elas continuam valendo.

Importar sprint
Importar sprint: documento, time pelo PRD, tarefas com dependências e o fluxo sugerido da tarefa escolhida.

Controles da tarefa

  • Iniciar, Pausar e Parar, na fila e no cabeçalho da tarefa. Na pausa, quem está rodando termina o turno e nada novo começa até você retomar. Parada (ou encerrada sem commit), a tarefa ganha Iniciar de novo, que abre um ciclo novo na mesma worktree. Tarefa que não conseguiu começar mostra o erro e Tentar de novo.
  • Fluxo sugerido: uma tarefa que ainda não começou mostra o fluxo que vai seguir (só as etapas que rodam, com o dev escalado), por que ainda está esperando e, à direita, o texto dela.
  • Ajustar no Estúdio: abre o fluxo da tarefa no Estúdio; Salvar para a tarefa grava uma cópia só dela (o modelo e as outras tarefas não mudam). Numa tarefa rodando, vale a partir do próximo ciclo.
  • Dependências: na fila, setas mudam a ordem e Tirar dependência deixa a tarefa começar do branch principal quando a outra parou.
  • Excluir (lixeira): para a tarefa, apaga a worktree com o que não foi salvo e todo o histórico. Se o branch tem commit, ele fica no repositório e o aviso diz o nome.
  • Remover worktree (no resumo de uma tarefa terminada): apaga a pasta da tarefa; o branch fica.
Tarefa na fila com o fluxo sugerido
Tarefa na fila: o fluxo que vai seguir, esperando a dependência terminar, e o texto da tarefa à direita.

Pendências

Tudo o que espera você vira uma pendência, numa caixa única para todas as tarefas, com notificação e o contador na mini-pill e na bandeja. Pode fechar o app: tudo fica guardado e a tarefa continua de onde parou.

  • Permissão: Permitir uma vez, Permitir nesta tarefa ou Negar (a persona segue sem aquilo e registra a alternativa). Responde na própria linha.
  • Pergunta de uma persona: sim ou não, escolha, múltipla ou texto, com a opção recomendada e Deixar a persona decidir. Se a opção muda o fluxo (ligar segurança ou banco, trocar persona), a mudança vira uma pendência à parte.
  • Dúvidas para você: as que a Helena não conseguiu responder aos devs, com a sugestão dela já preenchida.
  • Aprovação e commit manual: veja abaixo.
  • Exceção: a etapa não pôde seguir (passou do limite de voltas, falhou, devolveu bastão inválido). Tentar de novo, Assumir manualmente (você faz por fora e o fluxo segue) ou Encerrar. Se a persona tem substituta, chega junto uma mudança no fluxo propondo a troca; aprovada, a etapa recomeça com a substituta.
  • Teto de custo: a tarefa chegou ao teto e pausou; aumente, siga sem teto ou encerre.
Pergunta de um dev no painel lateral
Uma pergunta do dev back, aberta no nó dele, enquanto o dev front espera uma permissão.

Aprovações e commit

Aprovar entendimento: objetivo, critérios de aceite, fora de escopo e quem entra. Dá para trocar o dev de cada lado, ligar ou desligar front e back, segurança e banco, e comparar as versões da especificação (v1, v2…). Aprove (com ou sem mudanças) ou devolva com comentário para a Helena refazer.

Aprovar entendimento
Aprovar entendimento: critérios de aceite, versões da especificação e o time.

Aprovar entrega: o diff por arquivo, a saída dos testes, o resultado da Bia, o que foi corrigido no caminho (reprovações do Rui ou da Bia), as suas decisões e as sugestões não bloqueantes. Não aprovando, explique o motivo: a tarefa termina sem commit.

Aprovar entrega
Aprovar entrega: diff por arquivo, testes, Bia, corrigidos, decisões e sugestões.

Commit: no automático, o DevPulse faz o commit só com os arquivos da tarefa, na worktree dela. No manual, a pendência mostra a mensagem sugerida e os arquivos: Fazer o commit faz por você (dá para editar a mensagem), e Já fiz o commit confere que o commit existe antes de seguir — assim a tarefa que depende desta não começa sem o código. Push é sempre com você; o resumo da tarefa avisa quantos commits locais ainda não foram enviados.

Homologação e ajustes

O fim do fluxo deixa a tarefa pronta para homologação, não finalizada: quem pediu testa primeiro. No grupo Homologação do Painel, use Enviar para homologação e, quando voltar a resposta, Homologação aprovada (finaliza a tarefa) ou Registrar retorno: um item por apontamento, com o que está errado, onde, o esperado, o obtido, a severidade e a evidência. Cada apontamento ganha um código (H1-1, H1-2…) que aparece nos testes e no commit.

Registrar o retorno da homologação
Registrar retorno: um item por apontamento; o ajuste pode começar na hora.

O retorno abre um ciclo de ajuste (modelo Ajuste de tarefa). A Helena faz a triagem: bug, critério que faltou (vira critério novo na especificação), escopo novo (sugere uma tarefa à parte) ou não é problema (volta com a justificativa). Você confere e pode reclassificar o tipo e o lado antes de aprovar. Só o lado afetado roda: o dev escreve primeiro o teste que reproduz cada apontamento, o Rui revisa só o diff do ajuste e a Bia confirma os apontamentos e roda a regressão completa. O commit sai como fix: … — ajuste 1, com os apontamentos resolvidos. Se nada pedir mudança no código, o ajuste termina sem commit e a tarefa volta para a homologação. Parado no meio, o ajuste deixa os apontamentos abertos e Iniciar ajuste recomeça.

Aprovar a triagem da Helena
Aprovar triagem: a classificação de cada apontamento, o lado afetado e os critérios novos.

A faixa de ciclos (Ciclo 1, Ajuste 1…) troca o grafo pelo ciclo escolhido, e a partir do 3º ciclo aparece um alerta para conferir o escopo. À direita, a aba Homologação lista os apontamentos por retorno, com a triagem e a situação (aberto, resolvido, descartado, escopo novo); num escopo novo, Criar tarefa põe a tarefa na fila com início manual. Ao fechar um ajuste, a Helena propõe uma lição aprendida (ex.: em formulários, perguntar campos obrigatórios, formatos, mensagens e o botão salvar), que você edita, aprova ou descarta; aprovada, ela entra no checklist da Helena e nos testes negativos da Bia nas próximas tarefas do mesmo tipo de entrega, naquele projeto.

Tarefa em homologação depois de um ajuste
Homologação: ciclos da tarefa, ações e, à direita, a lição proposta e os apontamentos com a triagem.

O botão Lições do topo lista as lições de cada projeto: aprove as propostas, edite o texto e o tipo de entrega, desative, exclua ou acrescente uma à mão (sem tipo, vale para todas as entregas). No topo também ficam as métricas: ciclos por tarefa e escapes (bugs que só a homologação achou), com o total por tipo de apontamento na dica.

Lições aprendidas
Lições: a proposta da Helena para aprovar e as lições do projeto, editáveis.

Fluxo na seção Código

Enquanto uma tarefa roda num projeto, a seção Código mostra a sessão dela no seletor como ◆ Fluxo CHAVE, já escolhida: arquivos alterados, diff, revisar, reverter, abrir no editor e a conversa da persona da vez funcionam como em qualquer sessão. Na conversa, Abrir ao lado mostra o grafo da tarefa junto, com Iniciar, Pausar e Parar — é a mesma execução do Painel. Os pedidos de permissão das personas também aparecem ali.

Fluxo ao lado da conversa na seção Código
Seção Código: a sessão Fluxo OP-1427, o diff e, embaixo, a conversa com o grafo da tarefa ao lado.

Estúdio

Monte os seus fluxos arrastando personas e controles (Tarefa, Aprovação, Dúvidas para você, Portão de testes, Commit, Fim) e ligando as saídas às entradas — as ligações saem e chegam em qualquer lado do nó. O inspetor configura cada nó: modo, modelo, autonomia, condição (se segurança, se banco, se front, se back), junção, limite de voltas, substitutas, chapéus e skills. A validação aponta o que falta (ex.: commit sem aprovação antes). Testar desenho roda uma cópia com respostas automáticas, sem gastar tokens. Publicar versão nunca sobrescreve: tarefas em andamento ficam com a versão que começaram. Marque um fluxo como Modelo para ele aparecer primeiro em Nova tarefa, e use Nova tarefa com este fluxo para começar dali.

Estúdio de fluxos
Estúdio: paleta, canvas, inspetor do nó e validação.

Personas

São 20 personas prontas, em português, com chapéus (manuais técnicos) e skills curados. Edite identidade, chapéus, skills, comportamento (modelo, autonomia, ferramentas, modos) e voz; antes de salvar, Ver diferenças mostra o prompt como está e como vai ficar, e quais fluxos e execuções usam a persona. Cada edição é uma versão nova, com histórico e restauração. Quando uma versão nova do app traz mudança numa persona que você editou, ela chega como Atualização do catálogo, com o diff, para Aplicar ou descartar — a sua edição nunca é sobrescrita. Desativar tira a persona das próximas tarefas; Exportar grava a persona em .claude/agents/ de uma pasta, para usar fora do DevPulse. Os limites fixos (nunca push, não acionar outras personas, texto da tarefa é dado) valem para todas.

Cadastro de personas
Personas: lista com busca e o formulário em abas.

Fila, custo e segurança

  • Fila: até 3 tarefas em paralelo, cada uma na sua worktree; a próxima com início automático começa sozinha quando abre vaga. Pause a fila ou uma tarefa a qualquer momento.
  • Teto por tarefa (em R$): aviso a 80%; a 100% a tarefa pausa e pergunta se você quer aumentar, seguir sem teto ou encerrar.
  • Autonomia: baixa confirma a abordagem e cada arquivo; média pergunta sobre contrato, dados, dependências e segurança; alta só o que muda contrato, dados ou segurança. Instalar pacote, rede, .env e CI sempre perguntam.
  • Revisores pelo diff: se o código mexer em autenticação ou senhas, a revisão de segurança entra sozinha; em SQL ou migrações, a de banco — com aviso.
  • Troca de persona: no detalhe de um nó, escolha outra persona que trabalhe no mesmo modo; vale a partir da próxima etapa, e a nova persona recebe o último bastão daquela etapa.

9. Gastos

Gastos
Gastos: resumo, cotação, gráfico, gasto por modelo e orçamentos.

Os cartões mostram hoje, semana, mês e a projeção do mês, em reais com o valor em dólar embaixo. O gasto vem dos transcripts dos agentes (tokens reais, custo estimado pela tabela de preços) e das chamadas pelo proxy. Em planos de assinatura, o valor é o custo equivalente em API — útil para comparar modelos e sessões. Por modelo alterna entre hoje, semana e mês.

Orçamentos

Crie orçamentos diários, semanais ou mensais com os percentuais de alerta (ex.: 50, 80, 100). Ao cruzar cada um, chega uma notificação. O hard cap faz o proxy local recusar novas chamadas ao atingir 100%. Disparar alerta de teste mostra como o aviso aparece.

Cotação do dólar

Por padrão, a PTAX do Banco Central do dia (atualizada pelo botão ↻). Em Configurações → Moeda e câmbio dá para usar uma cotação fixa e somar IOF e spread do cartão.

Calculadora de tokens

Cole um texto ou escolha um arquivo para contar tokens localmente e estimar o custo em cada modelo, com os tokens de saída esperados. Contar via API pede a contagem exata à Anthropic (envia o texto).

Tabela de preços e conciliação

A tabela de preços por modelo vem com o app, mostra a data da versão e pode ser editada ou restaurada. A conciliação compara, por dia, a estimativa local com o custo informado pela API de custos da Anthropic — para isso, cadastre uma chave administrativa em Segurança.

10. Agentes

Agentes
Agentes: uma ficha por sessão, processos monitorados e logs.

Cada sessão do Claude Code vira uma ficha com a pasta, a intenção declarada, o custo, o uso de contexto (com alerta ao passar de 80%, configurável), a última atividade, o modelo, o branch e as linhas alteradas. O lápis permite dar um nome amigável e uma descrição — o nome passa a aparecer em todo o app.

Processos monitorados

Cadastre outros agentes ou ferramentas pelo nome do processo, pela linha de comando ou pelo PID — name:aider, cmd:python agent.py, pid:1234. Detectar agentes sugere processos conhecidos que estão rodando. Só o que está cadastrado aqui (e os subprocessos) pode ser encerrado pelo Kill Switch.

Kill Switch

O botão vermelho (na pill, na bandeja e aqui) pede confirmação e então encerra os processos cadastrados — primeiro com um pedido gentil e, após o tempo de espera configurado, à força — e interrompe as sessões com aprovação pendente. O modo de emergência dispensa a confirmação.

Live logs

Tudo o que o DevPulse registrou — edições, proxy, alertas, cotação — com filtro por texto.

11. Segurança

Segurança
Segurança: Proteções, credenciais no cofre, hooks e sanitizador.

Proteções

As Proteções barram comandos perigosos do agente antes de eles rodarem. O Claude Code consulta o DevPulse a cada comando de terminal; se o comando casar com uma regra, o DevPulse responde conforme a ação dela:

Regra (Pacote Essencial)ExemploAção
Apagar a raiz, a home ou a pasta acimarm -rf ~Bloqueia
Apagar ignorando a proteção da raizrm -rf --no-preserve-root /Bloqueia
Executar script baixado da internetcurl https://… | shBloqueia
Forçar push (reescreve o histórico remoto)git push --forcePergunta

Bloqueia: o comando não roda e o agente recebe o motivo, com a sugestão do que fazer no lugar. Pergunta: o próprio Claude Code pede a sua confirmação. As regras miram só o caso perigoso: rm -rf ./dist, curl -o arquivo, git push e git push --force-with-lease passam normalmente.

No cartão você liga ou desliga as Proteções e cada regra, e vê o histórico do que foi barrado, com o comando e a pasta do projeto. Cada bloqueio também gera uma notificação. As Proteções dependem dos hooks: se eles não estiverem instalados, ou forem de uma versão anterior à 0.1.3, o cartão mostra um aviso com o botão para instalar ou reinstalar.

Credenciais

Cadastre as chaves de API usadas pelas ações de IA, pelo proxy e pela conciliação (Anthropic, OpenAI, Qdrant…). Elas ficam no cofre do sistema operacional (Gerenciador de Credenciais do Windows, Secret Service/GNOME Keyring no Linux); o banco do app guarda só o rótulo e o final da chave.

Hooks do Claude Code (aprovação prévia)

Instalar hooks adiciona hooks HTTP ao ~/.claude/settings.json — o que será adicionado aparece antes, e uma cópia do arquivo original é guardada. A partir daí, novas sessões do Claude Code consultam o DevPulse antes de cada edição (ver portão de aprovação). Desinstalar hooks remove só o que o DevPulse adicionou. Hooks instalados por uma versão anterior aparecem como Desatualizados: use Reinstalar hooks para ativar as Proteções.

Sanitizador de segredos e detector de injeção

O sanitizador encontra chaves privadas, chaves e tokens (Anthropic, OpenAI, AWS, GitHub, Slack, Google, Stripe, JWT, Bearer), senhas em connection strings e dados pessoais (CPF, CNPJ, e-mail, cartão de crédito, telefone) e os troca por marcadores como [REDACTED:CPF] antes de você colar o texto num LLM. O detector de prompt injection dá uma nota de risco a um texto (ex.: uma página ou issue que o agente vai ler) e aponta os trechos suspeitos — é um alerta, não uma garantia. Tudo roda localmente.

Dados locais

Limpar histórico, snapshots e registros apaga sessões, alterações, uso, notificações e logs. Credenciais e configurações são mantidas.

12. Proxy

Proxy
Proxy: requisições nas últimas 24 h, rotas, VCR e registro de chamadas.

O proxy é um gateway local para as APIs de LLM. Tudo o que passa por ele entra nos gastos com o custo exato da resposta, e você ganha latência, tempo até o primeiro token (TTFT) e o registro de cada chamada.

Ativar e apontar o agente

  1. Clique em Ativar proxy (porta padrão 47822).
  2. Em Rotas, clique no ícone de copiar ao lado da rota: ele copia a variável de ambiente pronta, por exemplo
    export ANTHROPIC_BASE_URL=http://127.0.0.1:47822/anthropic
  3. Cole no terminal antes de iniciar o agente (ou no seu .bashrc/.zshrc). Para OpenAI, a variável é OPENAI_BASE_URL.

Registrar corpos guarda requisição e resposta para inspeção (clique numa linha); Mascarar segredos passa o sanitizador neles antes de gravar. Com um orçamento com hard cap, o proxy recusa chamadas ao estourar.

VCR e falhas simuladas

Gravar salva respostas reais; Reproduzir devolve a gravação para a mesma requisição, sem gastar tokens (replays não entram no gasto e aparecem marcados como VCR). Ótimo para testes e demonstrações. Falhas simuladas injetam latência extra, rate limit (429), erro de servidor (5xx) ou timeout numa porcentagem das chamadas — para ver como o seu agente se comporta quando a API falha.

13. Prompts

Prompts
Prompts: templates com variáveis e as demais abas de ferramentas.
AbaPara que serve
TemplatesPrompts reutilizáveis com variáveis {{nome}}. Ao salvar, cada variável vira um campo; Preencher monta o texto final.
ComparadorDiff entre duas versões de um prompt, com similaridade e tokens de cada uma.
RedundânciaEncontra instruções repetidas e estima quantos tokens são desperdiçados.
JSON SchemaValida a saída de um modelo contra um schema. Pode colar como veio: cercas ```json e texto em volta são removidos.
Few-shotMonta exemplos de entrada/saída — ou importa as últimas interações do proxy — e gera o bloco no formato de texto ou de mensagens JSON.
EvalsConjuntos de casos com expectativas (contains, notContains, regex, equals, jsonSchema, maxChars). Avalie saídas já informadas (offline) ou rode no modelo (gasta tokens), com histórico.
UtilitáriosÁrvore de diretórios do projeto, seletor de contexto (junta arquivos com segredos mascarados), JSON para tipos (TypeScript, Rust e Python) e ações de IA: explicar erro, gerar regex e documentar código.

14. RAG

RAG
RAG: testador de busca vetorial e similaridade entre textos.

O testador de busca consulta um Qdrant (o embedding da pergunta é gerado com a sua chave OpenAI) ou qualquer endpoint HTTP com um corpo de requisição usando {{query}} e {{k}}, e mostra os trechos retornados com a pontuação. A similaridade entre textos compara dois trechos de forma lexical (local) ou por embeddings (cosseno).

15. Configurações

Configurações
Configurações completas.
GrupoOpções
Aparência e idiomaPortuguês ou inglês, tema escuro ou claro, mini-pill completa ou compacta, cores de diff para daltonismo (azul/laranja).
Projetos observadosAdicionar e parar de observar pastas (o histórico fica até a retenção).
Sessões e retençãoMinutos sem alterações para encerrar a sessão, dias de histórico, padrões extras a ignorar (sintaxe .gitignore) e o comando do editor com {file} e {line}.
IntegraçõesLeitura dos transcripts do Claude Code, pasta e dias a importar, alerta de contexto, tempo de espera da aprovação, o que fazer sem resposta e o modelo das ações de IA.
Moeda e câmbioPTAX ou cotação fixa, IOF e spread do cartão, e a consulta online da PTAX.
Kill SwitchEspera antes de forçar o encerramento e modo de emergência.
AtualizaçõesBusca automática de versões novas e avisos (ao abrir e a cada 6 horas), Procurar agora e Instalar e reiniciar quando houver versão nova.
PrivacidadeMétricas anônimas (opt-in, desligado por padrão) e modo demonstração com dados fictícios.
SobreVersão, plataforma, pasta de dados e estatísticas do observador de arquivos.

16. Notificações, conta e Sobre

O sino abre a central de notificações — orçamentos, aprovações pendentes, contexto alto, comandos barrados pelas Proteções, versões novas — com Marcar todas como lidas. As mais importantes também aparecem como notificação do sistema.

Ali também chegam os avisos do DevPulse: manutenção, mudanças de plano ou pesquisas publicadas no site. Cada aviso aparece uma única vez e, quando tem link, traz o botão Abrir link. A consulta é a mesma das atualizações e é desligada junto com ela.

Central de notificações
Central de notificações.

O ícone de conta mostra o plano e ativa uma licença Pro com a chave recebida. O app funciona inteiro sem login. Sobre… (no rodapé do menu, na bandeja ou nas Configurações) mostra versão, pasta de dados e copyright.

Sobre o DevPulse AI
Janela Sobre.

17. Atalhos de teclado

AtalhoOndeAção
Ctrl+Shift+DGlobalAbrir ou esconder o painel
Ctrl+Shift+PGlobalMostrar ou esconder a mini-pill
Ctrl+1…9, 0PainelIr para a seção
Ctrl+BPainelRecolher o menu lateral
J K / N P / RCódigoArquivos / trechos / marcar revisado
Ctrl+Enter · Ctrl+I · Ctrl+⌫AprovaçãoAceitar · pedir ajuste · rejeitar
Ctrl+M · EscCódigoExpandir/recolher o chat
Enter · Shift+EnterChatEnviar · quebrar linha

No macOS, use ⌘ no lugar de Ctrl.

18. Solução de problemas

A pill não mexe e o painel não abre logo após instalar (Linux/Wayland).

Provavelmente há uma janela do sistema pedindo permissão para os atalhos globais, escondida atrás da pill. Use Alt+Tab para encontrá-la e responda.

Os atalhos globais não funcionam.

No Wayland eles dependem do portal do ambiente (GNOME 48+, KDE). Em versões sem suporte, use o menu da bandeja. No X11 e no Windows funcionam direto.

Não aparecem sessões em Agentes.

Confira em Configurações → Integrações se a leitura do Claude Code está ligada e se a pasta é a certa (padrão ~/.claude/projects). Use o Claude Code num projeto: a sessão aparece em segundos.

Os limites do plano mostram “—”.

Passe o mouse para ver o motivo. Em geral, o login do Claude Code expirou: abra o Claude Code para renovar. Contas só com chave de API não têm limites de plano.

Os valores aparecem com “~”.

São estimativas pela tabela de preços (tokens reais × preço). Passe pelo proxy ou use a conciliação para ter o custo informado pelo provedor.

As Proteções não barraram um comando.

Veja o cartão em Segurança → Proteções: os hooks precisam estar instalados e atualizados (reinstale se aparecer Desatualizados) e valem para sessões do Claude Code iniciadas depois. As regras miram só o caso perigoso — um rm -rf ./build dentro do projeto passa de propósito.

A atualização não instalou.

No Linux, a instalação pede a sua senha numa janela do sistema; se ela for cancelada, a faixa continua lá para tentar de novo. Sem internet, ou com a busca automática desligada, use Procurar agora em Configurações → Atualizações ou baixe na página de download.

Uma edição não passou pelo portão de aprovação.

Os hooks valem para sessões do Claude Code iniciadas depois da instalação, e o portão precisa estar ligado no projeto. Edições feitas fora do agente aparecem só no diff.

Não encontrou? Veja o FAQ ou escreva para suporte@devpulseai.app.br.