CLI Commands

whogitit provides a comprehensive CLI for viewing and managing AI attribution data.

Command Overview

Core Attribution Commands

Command	Description
`blame`	Show AI attribution for each line of a file
`show`	View attribution summary for a commit
`prompt`	View the prompt that generated specific lines
`summary`	Generate summary for a commit range (PRs)
`status`	Check pending attribution changes

Developer Integration Commands

Command	Description
`annotations`	Generate GitHub Checks API annotations
`pager`	Annotate git diff output with AI markers

Data Management Commands

Command	Description
`export`	Export attribution data as JSON/CSV
`retention`	Manage data retention policies
`audit`	View the audit log
`clear`	Discard pending changes without committing

Setup Commands

Command	Description
`setup`	Configure Claude Code integration (one-time)
`doctor`	Verify whogitit configuration
`init`	Initialize whogitit in a repository
`copy-notes`	Copy attribution between commits

Privacy Commands

Command	Description
`redact-test`	Test redaction patterns against text/files

Quick Reference

Viewing Attribution

# See AI attribution for a file
whogitit blame src/main.rs

# Show only AI-generated lines
whogitit blame src/main.rs --ai-only

# View commit summary
whogitit show HEAD

# Find prompt that generated a line
whogitit prompt src/main.rs:42

# Summarize a PR
whogitit summary --base main --format markdown

Developer Integration

# Generate GitHub Checks annotations for CI
whogitit annotations --base main --head HEAD

# Use as git pager for AI-annotated diffs
git config --global core.pager "whogitit pager"
git diff | whogitit pager

# Create git aliases
git config --global alias.ai-diff '!git diff | whogitit pager --no-pager'

Managing Data

# Check pending changes
whogitit status

# Clear pending without committing
whogitit clear

# Export all attribution data
whogitit export -o attribution.json

# Preview retention policy
whogitit retention preview

Setup Commands

# One-time global setup (configures Claude Code)
whogitit setup

# Verify all configuration
whogitit doctor

# Initialize repository hooks
whogitit init

# Initialize even if global setup incomplete
whogitit init --force

# Copy attribution (after cherry-pick or manual rebase recovery)
whogitit copy-notes <old-sha> <new-sha>
whogitit copy-notes <old-sha> <new-sha> --dry-run

Privacy Testing

# Test redaction patterns
whogitit redact-test --text "api_key=secret123"

# List available patterns
whogitit redact-test --list-patterns

# Show what would be redacted
whogitit redact-test --file .env --matches-only

Global Options

All commands support these options:

Option	Description
`--help`	Show help for any command
`--version`	Show version information

Output Formats

Many commands support multiple output formats:

Format	Flag	Use Case
Pretty	(default)	Human-readable terminal output
JSON	`--format json`	Machine parsing, scripts
Markdown	`--format markdown`	Documentation, PR comments
CSV	`--format csv`	Spreadsheets, data analysis

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments

Next Steps

Explore each command in detail:

Core Commands

blame - Line-level attribution
show - Commit summaries
prompt - Prompt lookup
summary - PR summaries

Developer Integration

annotations - GitHub Checks API
pager - Git diff annotations

Data & Privacy

export - Data export
retention - Data retention
audit - Audit log
redact-test - Privacy testing

Setup

setup - Global configuration
doctor - Configuration check
init - Repository setup
copy-notes - Copy attribution between commits

Keyboard shortcuts

whogitit