extract_why

CLI tool that mines Claude and Codex conversation transcripts and git history to surface why decisions were made — the intent and reasoning behind code changes.

Install

pip install git+https://github.com/schepens83/tools

Usage

extract_why [--project PROJECT] [--since YYYY-MM-DD] [--with-git-log] [--with-context]

Options

• --project — path to the project directory (default: current directory)
• --since — only include transcripts and commits after this date
• --with-git-log — include git commit messages in the output
• --with-context — include surrounding conversation context for each decision
• --backend — transcript source: claude, codex, or all (default: all)

Output

Prints a structured summary of decisions and motivations extracted from transcripts, suitable for feeding into a docs/WHY.md generation step.