AgentLens

Scan de repositórios para custos de contexto de agentes de IA. Detecta CLAUDE.md, AGENTS.md, .cursorrules, copilot-instructions.md e calcula custos de tokens para os principais LLMs.

Funciona de três formas — escolha a que se encaixa no seu fluxo.

---

App (HTML)

Zero instalação. Baixe agentlens.html, abra no browser.

• Analisa repositórios públicos do GitHub via API
• Carrega relatórios .json gerados pelo CLI
• Toggle de idioma PT/EN
• Aba Compare para comparar múltiplos repos

1. Baixe agentlens.html
2. Abra no Chrome, Firefox, Safari ou Edge
3. Cole: https://github.com/owner/repo → Analisar

All processing happens in your browser via the GitHub public API.

---

CLI

Analisa repositórios locais e gera relatório HTML + JSON.

# Com npx (sem instalação)
npx @hugofusinato/agentlens
npx @hugofusinato/agentlens /caminho/do/repo
npx @hugofusinato/agentlens --path . --path ../outro-repo

# Ou instale globalmente
npm install -g @hugofusinato/agentlens
agentlens /caminho/do/repo

# Opções úteis
agentlens --stdout          # JSON no stdout
agentlens --no-open         # não abre browser automaticamente
agentlens --out meu-repo    # nome do arquivo de saída

Gera agentlens-report.html e agentlens-report.json no diretório atual.

---

Servidor com histórico

API REST HTTP que analisa repositórios e persiste os resultados em banco de dados SQLite local.

npm install
node server.js              # porta 3000 (padrão)
PORT=8080 node server.js    # porta customizada

Endpoints

Método	Rota	Descrição
POST	/analyze	{ "path": "/caminho/repo" } — analisa e salva
GET	/history	Lista todas as análises salvas
GET	/history/:id	Análise completa por ID
DELETE	/history/:id	Remove uma análise

O app HTML pode ser apontado para GET /history para exibir o histórico de análises salvas.

O banco de dados fica em agentlens-history.db no diretório de trabalho. Cada análise salva a versão do CLI (cliVersion) para rastrear compatibilidade entre versões.

---

Testes

npm test

Roda testes unitários do core e testes de integração da API com node:test nativo (Node.js ≥ 18, sem dependências extras).

---

Config (opcional)

Crie .agentlens.json para definir múltiplos repos de uma vez:

{
  "repos": [
    { "path": ".", "name": "meu-repo" },
    { "path": "../outro-repo" }
  ],
  "output": "relatorio.html"
}

Veja .agentlens.example.json para referência completa.