whathaveidone

A terminal tool to summarize your Git commit history for daily standups, using AI (Gemini API).

Features

• Summarizes Git commit history for one or more projects
• Groups changes by day and topic
• Supports multiple repositories
• Customizable summary prompt
• Copy summary to clipboard with one keypress
• Mark commits with m, view all marked with s

Installation

Prerequisites

• Rust (for building)
• A Gemini API key

Build & Install

cargo install whathaveidone

Set up your Gemini API key

You must set your Gemini API key before running the app:

export GEMINI_API_KEY=your-key-here

Add this line to your shell profile (e.g. ~/.zshrc) to make it persistent across terminal sessions.

Configuration

whathaveidone uses a TOML file for configuration, allowing you to customize its behavior.

Configuration Hierarchy

The application loads settings from up to three locations in the following order of precedence (lower numbers are overridden by higher numbers):

1. Project Blueprint (whid.toml): A whid.toml file located in the project's root directory serves as the base configuration. This file is required and acts as a blueprint for user-specific settings.
2. User Configuration (~/.config/whid/whid.toml): On the first run, the application copies the project's whid.toml to a user-specific directory. This file stores your personal default settings.
3. Local Override (whid.toml): You can place a whid.toml file in the directory where you run the whid command. Its settings will override any of the above, which is useful for project-specific configurations.

Available Settings

Here's an example of the whid.toml file and the available settings:

# The default Gemini model to use for summaries.
# This can be overridden by the --model command-line flag.
gemini_model = "gemini-2.0-flash"

# Optional: Path to a custom prompt template file.
# If provided, this file will be used for AI summaries.
# This can be overridden by the --prompt command-line flag.
custom_prompt_path = "path/to/your/prompt.txt"

# Default language for the AI summary.
# Can be overridden by the --lang command-line flag.
lang = "english"

Usage

Run the app in your terminal:

whathaveidone
# or
whid

Gemini model selection

You can select the Gemini model version by setting the gemini_model in your whid.toml configuration file, or by using the --model <model> parameter as a command-line override. The default is gemini-2.0-flash.

Example:

whathaveidone --gemini gemini-1.5-pro
#or 
whathaveidone --gemini gemini-2.5-flash-preview-05-20

The selected model will be shown in the summary popup while waiting for the AI response.

Language selection

To use a specific language for the AI summary, add the --lang <language> parameter:

whathaveidone --lang german      # German
whid --lang english              # English (default)

Note: The translation is performed by Gemini itself. The --lang command-line flag will always override the lang setting from your configuration file.

Time interval selection

Use TAB or SHIFT-TAB for interval selection.

Alternativly: You can specify the start interval for commit history as parameter:

• 24 or today (default)
• 48
• 72 or yesterday
• week
• month

Example for 1 week in German:

whathaveidone week --lang german

Custom Date Range

You can specify a custom date range for the commit history using the --from and --to parameters. The date format is YYYY-MM-DD.

• --from YYYY-MM-DD: Start date for the commit history.
• --to YYYY-MM-DD: End date for the commit history. If not provided, it defaults to the current date.

Example:

whathaveidone --from 2023-01-01 --to 2023-01-31

Custom prompt

You can provide a custom prompt template file using the --prompt <filename.txt> option. Placeholders in your template will be replaced automatically:

• {from}: Start date (YYYY-MM-DD)
• {to}: End date (YYYY-MM-DD)
• {project} or {projectname}: Project name
• {interval}: Interval label (e.g. "week")
• {lang}: Language (e.g. "german", "english")
• {commits}: Commit data to be summarized

Example:

whathaveidone --prompt myprompt.txt

If the file cannot be loaded, the default prompt will be used.

The --prompt command-line flag will always override the custom_prompt_path from your configuration file.

Detailed commit view ("git log" style)

You can toggle a detailed, multi-line commit log view (similar to git log --format output) by pressing the d key in the commit list. This view shows the full commit message body and author for each commit, formatted in a pretty-printed, multi-line style.

Note: The detailed view is only recommended for smaller datasets (shorter timeframes or a single project). For large repositories or long timeframes, the output may be too large for the AI model to summarize effectively.

Keyboard Shortcuts

• Arrow keys / h j k l: Move between projects/commits
• Tab / Shift+Tab: Change time interval
• d: Toggle detailed commit view (multi-line, git log style)
• a or A: Show AI summary popup
• c: Copy summary to clipboard
• m: Mark/unmark commit
• s: Show popup with all marked commits
• Q: Quit

Links

• whathaveidone on Crates.io
• whathaveidone on GitHub

Development

coming soon