git-recap
Options

Options & API Reference

Every available flag for git-recap, typed out and documented. Grouped by their purpose to help you find what you need.

Time & Author Filtering

  • -s, --since <when>

    Commits since this date (default: "1 day ago" or $GIT_RECAP_SINCE)

  • -u, --until <when>

    Commits until this date (optional; or $GIT_RECAP_UNTIL)

  • --today

    Shortcut for --since "midnight"

  • --yesterday

    Yesterday 00:00 to today 00:00

  • --week

    Shortcut for --since "1 week ago"

  • -a, --author <who>

    Override author match (default: git user.email / user.name)

  • -A, --all-authors

    Include commits from every author

  • --include-merges

    Include merge commits (omitted by default)

Output Formatting

  • -p, --plain

    Paste-friendly output (no colors, no hashes)

  • --color <when>

    Colorize output: auto (default), always, or never

  • --summary-only

    Only print the final standup summary block

  • --flat

    Skip smart grouping; print a flat commit list

  • --json

    Machine-readable JSON summary for custom integrations

  • --max-length <n>

    Max summary bullet length (default: 88)

Integrations & System

  • -r, --recursive

    Deep-scan folders for Git repos (skips vendor/build trees)

  • --reviews

    Include your GitHub PR reviews via authenticated gh (optional network)

  • -V, --version

    Print version and exit

  • -h, --help

    Show help

Integration Use-Cases

Automating with JSON

If you want to build a custom Slack bot, Notion integration, or just pipe your standup into another script, the --json flag is your best friend. It outputs the fully grouped, structured summary as a JSON object, bypassing all human-readable ANSI formatting.

GitHub PR Reviews

If you spend a lot of time reviewing code rather than writing it, you can use the --reviews flag. This uses your authenticated gh CLI (GitHub's official CLI tool) to fetch PRs you have reviewed in the specified timeframe, placing them neatly in a "Code Review" section of your summary.