wtf

██╗    ██╗████████╗███████╗     ██████╗ ██████╗ ██████╗ ███████╗
██║    ██║╚══██╔══╝██╔════╝    ██╔════╝██╔═══██╗██╔══██╗██╔════╝
██║ █╗ ██║   ██║   █████╗█████╗██║     ██║   ██║██║  ██║█████╗  
██║███╗██║   ██║   ██╔══╝╚════╝██║     ██║   ██║██║  ██║██╔══╝  
╚███╔███╔╝   ██║   ██║         ╚██████╗╚██████╔╝██████╔╝███████╗
 ╚══╝╚══╝    ╚═╝   ╚═╝          ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝

understand code the honest way.

A CLI that reads your source code and explains it in a developer meme / greentext / brutally honest style — while still providing a useful technical summary.

No AI.
No API keys.
No network calls.

Just AST parsing and developer sarcasm.

$ wtf project

  Project analysis
──────────────────────────────────────────────────

  Files analyzed: 42

  Largest file:
    server.js (910 lines)

  Code smells detected:
    • large files
    • vague variable names

  Developer commentary:

    this project has strong "we'll refactor later" energy.

──────────────────────────────────────────────────

$ wtf legacy.js --roast

  🔥 Roasting: legacy.js
──────────────────────────────────────────────────

    > be developer
    > open legacy.js
    > see 420 lines
    > no comments
    > pain

  function handleData()

    this function works but nobody knows why.
    classic legacy energy.
    variable naming confidence level: zero.

──────────────────────────────────────────────────

---

Install

npm install -g wtf-code

---

Commands

Command	Description
wtf <file>	Analyze a file (default mode)
wtf <dir>	Analyze a directory
wtf blame <file>	See who wrote what
wtf rate <file>	Rate a file from 0 to 10
wtf diff	Explain the current git diff
wtf project	Full project analysis from cwd

Flags

Flag	Description
--roast	Full meme roast mode
--explain	Structured explanation
--complexity	Complexity analysis report
--therapy	Emotional support for your code
--summary	Short one-glance summary
--json	Raw JSON output
--max-files <n>	Max files in directory mode

See docs/commands.md and docs/flags.md for full examples.

---

How it works

Written in TypeScript. Analyzes JavaScript source files using Acorn.

1. Parses the AST
2. Extracts functions, classes, imports, variable names
3. Calculates code metrics, complexity, and nesting depth
4. Generates developer commentary from internal phrase pools

No AI involved. Fully deterministic. Fully offline.

---

Supported file types

Currently analyzes: JavaScript (.js .mjs .cjs .jsx)

TypeScript file analysis is planned.

---

Development

git clone https://github.com/ecx2f/wtf
cd wtf
npm install
npm run build
npm link

See docs/development.md for project structure and details.

---

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.

---

License

MIT