Sobre o projeto

agentacct é uma ferramenta local-first de "Inteligência de Trabalho de Agentes" que responde a uma pergunta prática: o que meus agentes de codificação estão realmente fazendo e quanto custou? Ela lê os logs locais de sessão dos agentes de codificação e apresenta atividades recentes, chamadas de ferramentas, etapas registradas, verificações, tokens e custo estimado em projetos e clientes. Os clientes suportados mencionados incluem Claude Code, Codex, Kimi Code, OpenCode, Hermes e outros, com uma matriz de cobertura documentada que classifica cada faixa de capacidade separadamente. O README observa que Claude Code e Codex atualmente possuem os recibos mais completos. A instalação é feita via pipx (Python >= 3.11 no macOS ou Linux; Windows apenas através do WSL), com um aplicativo macOS assinado também oferecido. A configuração executa `agentacct onboard` uma vez por máquina para detectar agentes, criar um armazenamento local e iniciar um gravador; `agentacct tui` abre um aplicativo de terminal. Uma instalação com escopo de projeto mantém tudo dentro do repositório. A interface centraliza-se em uma visão de Sessões e um "Recibo de Trabalho" por tarefa, combinando sessões participantes, resultado registrado, custo estimado, reivindicações e resultados de verificações, além de uma linha do tempo de atividades. Uma distinção fundamental é entre Reportado e Verificado: o "concluído" do próprio agente é apenas Reportado, enquanto Verificado requer verificações atuais aprovadas após a última alteração registrada. Tentativas com falha permanecem visíveis no histórico. Grupos de trabalho permitem apontar para uma pasta de projeto e ver quais agentes trabalharam lá, com detalhes da sessão e uma linha do tempo compartilhada entre agentes. O Painel mostra o trabalho registrado mais recente com cliente, horário, resultado, evidência e custo, e mantém verificações com falha históricas e bloqueadores em uma área separada de "Problemas registrados", em vez de torná-los a ordenação padrão. As visões de uso filtram independentemente por data, agente, modelo e provedor, com totais de intervalo por agente e modelo, um gráfico diário com alternância de tokens Frescos/Todos e detalhamentos que separam leituras e gravações de cache. Os tokens vêm dos registros do cliente; os custos são estimativas de tabela de preços marcadas com ≈ e explicitamente não são faturas. Janelas de cota reportadas pelo provedor e horários de reinicialização aparecem na mesma página. A interface de terminal oferece recibos, uso, capacidade e uma visão geral de revisão, incluindo uma aba de Trabalho ancorada em pasta com uma linha do tempo entre agentes navegável por teclado. O projeto enfatiza honestidade e privacidade: estimativas são rotuladas, dados ausentes são mostrados como lacuna em vez de zero, cada junção entre uso e trabalho registrado carrega um rótulo de confiança (exato, alto, médio, baixo), e o suporte é descrito por capacidade em vez de por logotipo. Ele registra metadados de trabalho, como nomes e categorias de ferramentas, arquivos tocados, comandos com credenciais removidas, códigos de saída, tokens e etapas registradas, mas não prompts, respostas de modelos ou transcrições. Ele lê apenas arquivos de sessão locais, escuta apenas em 127.0.0.1 e nunca armazena ou solicita chaves de API de provedores. Arquiteturalmente, mantém dois fluxos de evidência separados: o que foi usado (de arquivos de sessão do cliente) e o que foi feito (de etapas e verificações registradas via MCP, além de verificações de máquina, como execuções de teste), unidos por IDs reais de cliente com confiança rotulada. O Claude Code vincula IDs através de uma ponte de gancho instalada; Codex e OpenCode são correspondidos a partir de seus próprios logs no momento da importação; Hermes junta-se apenas em IDs passados explicitamente. As etapas de desinstalação interrompem processos gerenciados, removem a inicialização automática se instalada, desinstalam o pacote e, opcionalmente, excluem o armazenamento local e as entradas de configuração do cliente. A documentação cobre material de referência, matriz de cobertura, arquitetura, limites de segurança, modelo de ameaça à privacidade, exemplos trabalhados e uma demonstração completa.