GitGuru

gg config

View and modify GitGuru configuration settings.

Usage

bash
gg config --list              # Show all settings
gg config --get <key>         # Get a specific setting
gg config --set <key> <value> # Set a specific setting

Options

OptionDescription
--listShow all configuration settings
--get <key>Get a specific configuration value
--set <key> <value>Set a configuration value
--unset <key>Remove a configuration value
--resetReset all settings to defaults

Configuration Keys

Available configuration settings:

KeyDescriptionDefault
ai.modelGemini model to usegemini-1.5-pro
ai.commit.enabledEnable AI commit messages by defaulttrue
ai.diff.enabledEnable AI diff summaries by defaulttrue
ai.status.enabledEnable AI status analysis by defaultfalse
ai.log.enabledEnable AI log analysis by defaultfalse

Examples

List All Configuration

bash
$ gg config --list

GitGuru Configuration
────────────────────────────────────────────────────────────

ai.model            = gemini-1.5-pro
ai.commit.enabled   = true
ai.diff.enabled     = true
ai.status.enabled   = false
ai.log.enabled      = false
apiKey              = ****...****  (hidden)

Config file: ~/.gitguru/config.json

Get and Set Values

bash
# Get a specific value
gg config --get ai.model
# Output: gemini-1.5-pro

# Set a new value
gg config --set ai.model=gemini-1.5-flash

# Set AI features
gg config --set ai.commit.enabled=true

Change AI Model

bash
# Use most capable model
gg config --set ai.model=gemini-1.5-pro

# Use faster model
gg config --set ai.model=gemini-1.5-flash

# Use latest experimental
gg config --set ai.model=gemini-2.0-flash-exp

Enable/Disable AI Features

bash
# Enable AI commit messages by default
gg config --set ai.commit.enabled=true

# Enable AI diff summaries
gg config --set ai.diff.enabled=true

# Enable AI status analysis
gg config --set ai.status.enabled=true

# Enable AI log analysis
gg config --set ai.log.enabled=true
Override Flags
You can override default settings per command using --ai or --no-ai flags:
  • gg commit --ai - Force AI generation
  • gg status --no-ai - Disable AI analysis

Configuration File

Configuration is stored in ~/.gitguru/config.json:

json
{
  "apiKey": "YOUR_API_KEY",
  "model": "gemini-1.5-pro",
  "aiCommitEnabled": true,
  "aiDiffEnabled": true,
  "aiStatusEnabled": false,
  "aiLogEnabled": false
}

Environment Variable

You can also set the API key via environment variable:

bash
export GEMINI_API_KEY="your-api-key"

Interactive Configuration

Run gg config without options for interactive setup:

bash
$ gg config

🔧 GitGuru Configuration
────────────────────────────────────────────────────────────

Configure AI features:

? Enable AI commit messages by default? (Y/n)
? Enable AI diff summaries by default? (Y/n)
? Enable AI status analysis by default? (y/N)
? Enable AI log analysis by default? (y/N)

✓ Configuration saved!