What it does

CodeWhy records redacted AI coding-session evidence so you can trace a file, line, feature, or commit back to the agent session that changed it—including intent, checks, risks, and later interactions.

• Works with Codex, Claude Code, Gemini CLI, OpenCode, and Cursor
• Keeps private runtime data under .git; shareable records live under .codewhy
• Answers locally by default, with optional BYOK synthesis

Install

npm install -g codewhy
cd your-git-repository
codewhy init
codewhy setup all

Example

codewhy file src/auth/session.ts
codewhy why src/auth/session.ts:42
codewhy ask src/auth/session.ts "What changed, why, and which tests passed?" --local

Answers cite their evidence with session, commit, check, and risk references instead of inferring intent from code alone.

Use codewhy --json <command> for automation. Run codewhy --help for the complete command list.

Learn more

GitHub · Operations and privacy · Issues · Core library

MIT © CodeWhy contributors