Point it at a repository. decoder first maps every file without AI, then teams of AI agents write what the code does, how it is built and where the risks are. Every claim points to the exact line of code, and a second pass checks each one.Aponte para um repositório. O decoder primeiro mapeia cada arquivo sem IA, depois equipes de agentes de IA escrevem o que o código faz, como ele é construído e onde estão os riscos. Cada afirmação aponta para a linha exata do código, e uma segunda passada confere cada uma.
> /decode https://github.com/owner/repoowner/repoFree for noncommercial use.Gratuito para uso não comercial. LicenseLicença
A payment is attempted up to three times, waiting longer after each failure, before the order is marked as failed.Um pagamento é tentado até três vezes, com uma espera maior depois de cada falha, antes de o pedido ser marcado como falho.
"Order" is the central entity: invoices, shipments and refunds all point back to it."Pedido" é a entidade central: faturas, entregas e reembolsos apontam todos para ele.
The login endpoint appears to have no limit on repeated attempts. The code suggests it, but a proxy setting outside the repository could add one.O login parece não ter limite de tentativas repetidas. O código sugere isso, mas uma configuração fora do repositório poderia adicionar um limite.
"Uses Redis as a cache." The second pass found no code that backs this up, so the report says so instead of repeating it."Usa Redis como cache." A segunda passada não achou código que sustente isso, então o relatório diz isso em vez de repetir a afirmação.
Like an excavation: survey the ground first, dig carefully, catalogue every find, then have someone check the catalogue.Como numa escavação: primeiro o levantamento do terreno, depois a escavação com cuidado, cada achado catalogado, e alguém conferindo o catálogo no fim.
A GitHub link or a folder on your computer. Small projects and huge ones.Um link do GitHub ou uma pasta no seu computador. Projetos pequenos e enormes.
Plain code maps every file, function, dependency and change history. This part spends no AI tokens.Código comum mapeia cada arquivo, função, dependência e histórico de mudanças. Essa parte não gasta tokens de IA.
Many agents read the files in parallel. Then three specialists write the architecture, the business domain and the risk audit.Muitos agentes leem os arquivos em paralelo. Depois, três especialistas escrevem a arquitetura, o domínio do negócio e a auditoria de riscos.
A second pass tries to prove each claim wrong. What survives goes into one report, from a one-page summary down to each file.Uma segunda passada tenta provar que cada afirmação está errada. O que sobrevive vai para um relatório, do resumo de uma página até cada arquivo.
One folder you can read top to bottom. Start with the summary; go deeper only where you need to.Uma pasta que dá para ler de cima a baixo. Comece pelo resumo; aprofunde só onde precisar.
What this repository isO que este repositório é
A billing service for a small shipping company: it takes orders, charges cards and issues invoices. It is a Python API with a nightly job that reconciles paymentsUm serviço de cobrança de uma pequena transportadora: recebe pedidos, cobra cartões e emite faturas. É uma API em Python com uma rotina noturna que concilia pagamentos jobs/reconcile.py:8.
What works wellO que funciona bem
Failed payments are retried safely before an order is marked failedPagamentos que falham são tentados de novo com segurança antes de o pedido ser marcado como falho src/billing/retry.py:41.
What to fix firstO que corrigir primeiro
Add a limit on repeated login attemptsAdicionar um limite de tentativas de login repetidas api/auth.py:118.
| SiteSítio | harbor-ledger | Tier | small |
|---|---|---|---|
| SheetFolha | 1 / 9 | FindsAchados | 2 verified, 1 weak, 1 unsupported2 verificados, 1 fraco, 1 sem suporte |
AI can sound sure and be wrong. So every sentence in the report carries the exact place in the code it comes from, and a separate reviewer tries to knock it down.A IA pode soar segura e estar errada. Por isso, cada frase do relatório carrega o lugar exato do código de onde veio, e um revisor separado tenta derrubá-la.
"A payment is attempted up to three times.""Um pagamento é tentado até três vezes."
The reviewer opened the cited line and it says what the claim says.O revisor abriu a linha citada e ela diz o que a afirmação diz.
"Login has no limit on repeated attempts.""O login não tem limite de tentativas repetidas."
The code points that way, but not strongly enough. Treat it as a lead, not a fact.O código aponta nessa direção, mas não com força suficiente. Trate como pista, não como fato.
"Uses Redis as a cache.""Usa Redis como cache."
No code backs it up. It stays visible in the review, marked, instead of quietly becoming "true".Nenhum código sustenta. Ela continua visível na revisão, marcada, em vez de virar "verdade" em silêncio.
Synthetic finds from the fictional harbor-ledger repository, the same ones pinned in the drawing at the top.Achados sintéticos do repositório fictício harbor-ledger, os mesmos marcados no desenho do topo.
Before the agents start, plain code has already listed every function and import, so the agents describe what is there instead of guessing. A quality check then measures how many files and functions the report actually covers.Antes de os agentes começarem, código comum já listou cada função e cada import, então os agentes descrevem o que existe em vez de adivinhar. Depois, uma verificação de qualidade mede quantos arquivos e funções o relatório realmente cobre.
decoder measures the repository first and sizes the dig to match: more agents join as the code grows, each one with a slice small enough to read carefully.O decoder mede o repositório primeiro e dimensiona a escavação: mais agentes entram conforme o código cresce, cada um com uma fatia pequena o bastante para ler com cuidado.
Choosing between projects, or merging them? Each one is decoded, then lined up side by side: what they share, where they differ, and what only one of them does.Escolhendo entre projetos, ou juntando-os? Cada um é decodificado e depois alinhado lado a lado: o que têm em comum, onde divergem e o que só um deles faz.
| CapabilityCapacidade | harbor-ledger | quay-pay | dock-books |
|---|---|---|---|
| Card paymentsPagamento com cartão | |||
| Payment retriesNova tentativa de pagamento | |||
| InvoicesFaturas | |||
| Multi-currencyVárias moedas |
Anyone who has to understand code they did not write.Qualquer pessoa que precisa entender um código que não escreveu.
Free for noncommercial use under the PolyForm Noncommercial license: personal projects, study, and noncommercial organizations. Commercial use needs a separate license.Gratuito para uso não comercial, sob a licença PolyForm Noncommercial: projetos pessoais, estudo e organizações sem fins comerciais. Uso comercial precisa de uma licença separada. Read the licenseLer a licença
You need two free tools on your computer: Python 3.12 or newer (the language decoder is written in) and Claude Code, Anthropic’s coding assistant, signed in to your account. Codex is optional. Not technical? Hand steps 1 and 2 to a developer; step 3 is the part you read.Você precisa de duas ferramentas no computador: o Python 3.12 ou mais novo (a linguagem em que o decoder é escrito) e o Claude Code, o assistente de programação da Anthropic, conectado à sua conta. O Codex é opcional. Não é da área técnica? Passe os passos 1 e 2 para alguém de desenvolvimento; o passo 3 é a parte que você lê.
Paste these into the terminal, one at a time. They download decoder and install it in its own folder, without touching the rest of your computer.Cole estes comandos no terminal, um de cada vez. Eles baixam o decoder e o instalam numa pasta própria, sem mexer no resto do computador.
$ git clone https://github.com/ogabrielalonso/decoder.git && cd decoder$ python -m venv .venv$ .venv/bin/pip install -e ".[analysis,knowledge,dev]"Open Claude Code inside the decoder folder and type:Abra o Claude Code dentro da pasta do decoder e digite:
> /decode https://github.com/owner/repoIt runs every stage on its own: the survey, the agent teams, the quality check, the second pass and the report. A local folder works too.Ele roda todas as etapas sozinho: o levantamento, as equipes de agentes, a verificação de qualidade, a segunda passada e o relatório. Uma pasta local também funciona.
Open docs/decode/<name>/final_report.md and start with the executive summary.Abra docs/decode/<nome>/final_report.md e comece pelo resumo executivo.
auth.py:118.O arquivo e a linha de onde vem uma afirmação, como auth.py:118.The lib is deterministic and testable; no lib module calls a model. Agents only receive prompts the lib has already filled with facts.A lib é determinística e testável; nenhum módulo da lib chama um modelo. Os agentes só recebem prompts que a lib já preencheu com fatos.
The /decode command (shipped in .claude/) runs the whole pipeline, fanning workers out through the decode-execute workflow. decoder execute runs only static analysis and the four teams as headless, read-only claude -p (or codex exec) subprocesses; QA and synthesis are then decoder qa run and decoder synthesize.O comando /decode (que vem em .claude/) roda o pipeline inteiro, distribuindo os workers pelo workflow decode-execute. decoder execute roda só a análise estática e as quatro equipes como subprocessos headless e só leitura de claude -p (ou codex exec); QA e síntese vêm depois com decoder qa run e decoder synthesize.
A SQLite dependency graph, filled on every decode; add --index-vectors to also index symbols in ChromaDB with local embeddings (BAAI/bge-small-en-v1.5). decoder knowledge neighbors and search query it offline.Um grafo de dependências em SQLite, preenchido em todo decode; com --index-vectors, os símbolos também são indexados no ChromaDB com embeddings locais (BAAI/bge-small-en-v1.5). decoder knowledge neighbors e search consultam offline.
decoder eval-models runs candidate models on the same workers and scores them against an Opus gold standard plus deterministic floor checks.decoder eval-models roda modelos candidatos nos mesmos workers e pontua contra um padrão-ouro do Opus mais checagens determinísticas mínimas.
156 tests across every layer; ruff and mypy clean. Version 1.1.0. Known limits: filename-only fuzzy matching in compare, heuristic token counting.156 testes em todas as camadas; ruff e mypy limpos. Versão 1.1.0. Limites conhecidos: casamento aproximado só por nome de arquivo no compare, contagem de tokens heurística.