Exorcist: I made the ghosts of legacy Java code explain themselves (and tried to stop them lying)

说明与用途

Exorcist 自动识别 Java 类的作者，生成逐行解释，检测代码缺陷，并提出安全重构方案，所有操作均在本地完成。

问题

Legacy Java codebases contain hidden code smells and undocumented decisions that are hard to discover and refactor.

结果

Exorcist can read a Git repo, identify the main author per class, generate first‑person explanations with line citations, list code smells, and produce safe refactor diffs—all locally, without writing to disk.

工作流

• summon <repo> – list classes with ghost info
• possess <Class> – ghost explains class with line citations
• confess – ghost lists code smells with line numbers
• exorcise – ghost proposes refactoring as a diff
• epitaph – ASCII tombstone

证据

Exorcist is a terminal app that reads a Git repository, works out who really wrote each Java class, and lets the ghost of its main author explain the class in first person, confess its sins line by line, and propose a refactoring as a diff.

来源

Reading the whole history takes under five seconds

来源

The first confess run invented an IOException in two items (with the right line numbers, wrong content) and repeated one sin twice.

来源

The first exorcise produced a diff that doesn't compile.

来源