O que thanhtra faz?
Thanh Tra — inspetor de segurança para código vibe. Ferramentas CLI para evidência determinística + skill de agente multiplataforma. Baseado no vbsec licenciado como MIT.
Visão Geral
Thanh Tra é uma skill de segurança de código que ajuda desenvolvedores e agentes de IA a identificar vulnerabilidades e práticas inseguras em projetos de código gerado rapidamente (vibe code). Ele oferece uma abordagem determinística baseada em CLI, que produz resultados consistentes e auditáveis.
Funcionalidades
- CLI-first: Executa verificações de segurança a partir da linha de comando, gerando relatórios determinísticos.
- Multi-plataforma: Compatível com agentes como Claude Code, Cursor e Codex.
- Baseado em vbsec: Utiliza o framework vbsec (MIT) como núcleo de análise.
- Evidência Determinística: Fornece resultados replicáveis e sem ambiguidade, ideais para integração contínua.
Instalação
# via npm (se disponível)
npm install -g thanhtra
# ou clone o repositório
git clone https://github.com/aspelldenny/thanhtra.git
cd thanhtra
Uso
# Executar verificação padrão
thanhtra scan
# Verificar diretório específico
thanhtra scan ./caminho/do/projeto
# Gerar relatório em formato JSON
thanhtra scan --json
Configuração
Crie um arquivo thanhtra.config.json na raiz do projeto:
{
"rules": ["injeção-sql", "xss", "credenciais-hardcoded"],
"ignorar": ["node_modules", "dist"],
"saida": "terminal"
}
Integração com Agentes
Adicione ao seu agente (ex: Claude Code) a permissão para executar thanhtra no diretório do projeto. Exemplo de prompt:
Execute thanhtra scan para verificar a segurança do código atual.
Licença
MIT — baseado no projeto vbsec.
Contribuição
Contribuições são bem-vindas! Abra issues ou PRs no repositório oficial.