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
- Baixe DevPulse AI_0.1.4_x64-setup.exe (recomendado). O
.msié para instalação gerenciada por TI. - Dê dois cliques no arquivo. Se aparecer “O Windows protegeu o computador”, clique em Mais informações → Executar assim mesmo (veja abaixo).
- 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

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
- Abra o painel e vá em Código.
- Clique em Adicionar projeto e escolha a pasta do repositório.
- Pronto: a partir daí cada arquivo alterado na pasta aparece na lista, com o diff. Pastas como
.git,node_modulesetargetsã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.

O que cada anel mostra
| Bloco | O que significa |
|---|---|
| Orçamento | Quanto 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 rate | Gasto 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 atual | Custo 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 · Haiku | Um 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 modelos | Total de hoje, somando todos os modelos e os ajustes de custo reportado. |
| Agentes | Sessõ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ódigo | Linhas adicionadas e removidas na sessão; pulsa enquanto o agente escreve. |
| Botão vermelho | Kill 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.

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.

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

- 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.

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.

| Ação | Atalho | O que acontece |
|---|---|---|
| Aceitar alteração | Ctrl+Enter | Libera a gravação. Com várias na fila, há também Aceitar todas da fila. |
| Pedir ajuste | Ctrl+I | Abre um campo para dizer o que mudar (ex.: “use anyhow em vez de unwrap”); o agente recebe o comentário e tenta de novo. |
| Rejeitar | Ctrl+⌫ | 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.
0pede em qualquer tamanho.

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.

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.

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.

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.

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.

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.

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.

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 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.

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.

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.

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.

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.

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.

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.

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.

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,
.enve 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

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

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

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) | Exemplo | Ação |
|---|---|---|
| Apagar a raiz, a home ou a pasta acima | rm -rf ~ | Bloqueia |
| Apagar ignorando a proteção da raiz | rm -rf --no-preserve-root / | Bloqueia |
| Executar script baixado da internet | curl https://… | sh | Bloqueia |
| Forçar push (reescreve o histórico remoto) | git push --force | Pergunta |
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

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
- Clique em Ativar proxy (porta padrão 47822).
- 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 - 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

| Aba | Para que serve |
|---|---|
| Templates | Prompts reutilizáveis com variáveis {{nome}}. Ao salvar, cada variável vira um campo; Preencher monta o texto final. |
| Comparador | Diff entre duas versões de um prompt, com similaridade e tokens de cada uma. |
| Redundância | Encontra instruções repetidas e estima quantos tokens são desperdiçados. |
| JSON Schema | Valida a saída de um modelo contra um schema. Pode colar como veio: cercas ```json e texto em volta são removidos. |
| Few-shot | Monta 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. |
| Evals | Conjuntos 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

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

| Grupo | Opções |
|---|---|
| Aparência e idioma | Português ou inglês, tema escuro ou claro, mini-pill completa ou compacta, cores de diff para daltonismo (azul/laranja). |
| Projetos observados | Adicionar e parar de observar pastas (o histórico fica até a retenção). |
| Sessões e retenção | Minutos 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ções | Leitura 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âmbio | PTAX ou cotação fixa, IOF e spread do cartão, e a consulta online da PTAX. |
| Kill Switch | Espera antes de forçar o encerramento e modo de emergência. |
| Atualizações | Busca 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. |
| Privacidade | Métricas anônimas (opt-in, desligado por padrão) e modo demonstração com dados fictícios. |
| Sobre | Versã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.

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.

17. Atalhos de teclado
| Atalho | Onde | Ação |
|---|---|---|
| Ctrl+Shift+D | Global | Abrir ou esconder o painel |
| Ctrl+Shift+P | Global | Mostrar ou esconder a mini-pill |
| Ctrl+1…9, 0 | Painel | Ir para a seção |
| Ctrl+B | Painel | Recolher o menu lateral |
| J K / N P / R | Código | Arquivos / trechos / marcar revisado |
| Ctrl+Enter · Ctrl+I · Ctrl+⌫ | Aprovação | Aceitar · pedir ajuste · rejeitar |
| Ctrl+M · Esc | Código | Expandir/recolher o chat |
| Enter · Shift+Enter | Chat | Enviar · 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 ./builddentro 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.