devcommit 0.1.4.6__tar.gz → 0.1.4.8__tar.gz

{devcommit-0.1.4.6 → devcommit-0.1.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devcommit
-Version: 0.1.4.6
+Version: 0.1.4.8
 Summary: AI-powered git commit message generator
 License: GNU GENERAL PUBLIC LICENSE
                                 Version 3, 29 June 2007
@@ -713,6 +713,9 @@ A command-line AI tool for autocommits.
 - 🚀 Automatic commit generation using AI
 - 📁 Directory-based commits - create separate commits for each root directory
 - 🎯 Interactive mode to choose between global or directory-based commits
+- 📄 **Commit specific files or folders** - Stage and commit only selected files/directories
+- 🔄 **Regenerate commit messages** - Don't like the suggestions? Regenerate with one click
+- 🚀 **Push to remote** - Automatically push commits after committing
 - ⚙️ Flexible configuration - use environment variables or .dcommit file
 - 🏠 Self-hosted model support - use your own AI infrastructure
 - 🆓 Multiple free tier options available
@@ -721,24 +724,27 @@ A command-line AI tool for autocommits.
 
 ## Installation
 
-1. **Install DevCommit**  
-   
+1. **Install DevCommit**
+
    **Option 1: Using pip (local installation)**
+
    ```bash
    pip install devcommit
    ```
-   
+
    **Option 2: Using pipx (global installation, recommended)**
+
    ```bash
    # Install pipx if you don't have it
    python3 -m pip install --user pipx
    python3 -m pipx ensurepath
-   
+
    # Install DevCommit globally
    pipx install devcommit
    ```
+
    > **💡 Why pipx?** pipx installs CLI tools in isolated environments, preventing dependency conflicts while making them globally available.
-   
+
    **All AI providers are included by default!** ✅ Gemini, OpenAI, Groq, Anthropic, Ollama, and Custom API support.
 
 2. **Set Up Configuration (Required: API Key)**  
@@ -747,19 +753,21 @@ A command-line AI tool for autocommits.
    **Priority Order:** `.dcommit` file → Environment Variables → Defaults
 
    ### Option 1: Environment Variables (Quickest)
+
    ```bash
    # Using Gemini (default)
    export GEMINI_API_KEY='your-api-key-here'
-   
+
    # Or using Groq (recommended for free tier)
    export AI_PROVIDER='groq'
    export GROQ_API_KEY='your-groq-key'
-   
+
    # Add to ~/.bashrc or ~/.zshrc for persistence
    echo "export GEMINI_API_KEY='your-key'" >> ~/.bashrc
    ```
 
    ### Option 2: .dcommit File (Home Directory)
+
    ```bash
    cat > ~/.dcommit << 'EOF'
    GEMINI_API_KEY = your-api-key-here
@@ -772,6 +780,7 @@ A command-line AI tool for autocommits.
    ```
 
    ### Option 3: .dcommit File (Virtual Environment)
+
    ```bash
    mkdir -p $VIRTUAL_ENV/config
    cat > $VIRTUAL_ENV/config/.dcommit << 'EOF'
@@ -797,6 +806,7 @@ devcommit
 ### Basic Usage
 
 - **Stage all changes and commit:**
+
   ```bash
   devcommit --stageAll
   ```
@@ -823,6 +833,7 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
 #### Command-Line Usage
 
 - **Interactive mode (auto):** When you have changes in multiple directories, DevCommit will automatically ask if you want to:
+
   - Create one commit for all changes (global commit)
   - Create separate commits per directory
 
@@ -834,10 +845,103 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
   ```
 
 When using directory-based commits, you can:
+
 1. Select which directories to commit (use Space to select, Enter to confirm)
 2. For each selected directory, review and choose a commit message
 3. Each directory gets its own commit with AI-generated messages based on its changes
 
+### Commit Specific Files or Folders
+
+DevCommit allows you to commit specific files or folders. This is useful when you want to commit only certain changes without affecting other staged files.
+
+**Usage:**
+
+```bash
+# Commit specific files (must be staged first)
+git add file1.py file2.py
+devcommit --files file1.py file2.py
+
+# Stage and commit specific files in one command
+devcommit --stageAll --files file1.py file2.py
+
+# Commit specific folders (must be staged first)
+git add src/ tests/
+devcommit --files src/ tests/
+
+# Stage and commit multiple directories
+devcommit -s -f src/core src/modules/account/ src/modules/auth/
+
+# Short form
+devcommit -s -f file1.py file2.py
+```
+
+When using `--files` or `-f`:
+
+- Without `--stageAll`: Only commits files that are already staged (filters staged files to match specified paths)
+- With `--stageAll`: Stages the specified files/folders and then commits them
+- AI generates commit messages based on changes in those files
+- Works with both individual files and entire directories
+- Files with no changes are automatically filtered out
+
+#### Commit Mode Behavior with `--files`
+
+The `--files` flag respects your `COMMIT_MODE` setting:
+
+- **`COMMIT_MODE=directory`** with `--files`:
+  - **Individual files**: Each file gets its own separate commit
+    - Example: `devcommit -f src/test1.py src/test2.py` creates 2 separate commits
+  - **Directories**: Each directory gets one commit containing all its files
+    - Example: `devcommit -f src/core src/modules/account/` creates 2 commits (one per directory)
+
+- **`COMMIT_MODE=global`** with `--files`:
+  - All specified files/directories are committed together in a single commit
+  - Example: `devcommit -f src/test1.py src/test2.py` creates 1 commit for both files
+
+- **`COMMIT_MODE=auto`** with `--files`:
+  - Always prompts you to choose between one commit for all files or separate commits
+  - If you select directory mode: individual files get separate commits, directories get one commit each
+  - If you select global mode: everything is committed together
+
+### Push to Remote
+
+DevCommit can automatically push your commits to the remote repository after committing.
+
+**Usage:**
+
+```bash
+# Commit all staged changes and push
+devcommit --push
+
+# Commit specific files and push
+devcommit --files file1.py file2.py --push
+
+# Stage, commit, and push in one command
+devcommit --stageAll --push
+
+# Short form
+devcommit -p
+devcommit -f file1.py -p
+```
+
+**Note:** The push operation will only execute if commits were successfully made. If you cancel the commit, the push will be skipped.
+
+### Regenerate Commit Messages
+
+Don't like the AI-generated commit messages? You can regenerate them on the fly!
+
+When viewing commit message options, you'll see:
+- Numbered commit message suggestions
+- ✏️ Enter custom message
+- 🔄 **Regenerate commit messages** (new!)
+- ❌ Cancel
+
+Selecting "Regenerate commit messages" will:
+- Call the AI again to generate new suggestions
+- Show the new messages in the same prompt
+- Allow you to regenerate again or select a message
+
+This works for all commit modes (global, directory, and per-file commits).
+
 ### Additional Options
 
 - `--excludeFiles` or `-e`: Exclude specific files from the diff
@@ -845,6 +949,8 @@ When using directory-based commits, you can:
 - `--commitType` or `-t`: Specify the type of commit (e.g., conventional)
 - `--stageAll` or `-s`: Stage all changes before committing
 - `--directory` or `-d`: Force directory-based commits
+- `--files` or `-f`: Stage and commit specific files or folders (can specify multiple)
+- `--push` or `-p`: Push commits to remote after committing
 
 ### Examples
 
@@ -857,24 +963,46 @@ devcommit --commitType conventional
 
 # Exclude lock files
 devcommit --excludeFiles package-lock.json yarn.lock
+
+# Stage and commit specific files
+devcommit --files file1.py file2.py
+
+# Stage and commit specific folders
+devcommit --files src/ tests/
+
+# Stage and commit multiple files and folders at once
+devcommit --files src/ file1.py tests/ config.json
+
+# Commit and push
+devcommit --push
+
+# Commit specific files and push
+devcommit --files file1.py file2.py --push
+
+# Stage and commit multiple directories with directory mode
+devcommit -s -f src/core src/modules/account/ --directory
+
+# Stage and commit, then push
+devcommit -s -f src/core src/modules/account/ -p
 ```
 
 ## AI Provider Support
 
 DevCommit now supports **multiple AI providers**! Choose from:
 
-| Provider | Free Tier | Speed | Quality | Get API Key |
-|----------|-----------|-------|---------|-------------|
-| 🆓 **Gemini** | 15 req/min, 1M/day | Fast | Good | [Get Key](https://aistudio.google.com/app/apikey) |
-| ⚡ **Groq** | Very generous | **Fastest** | Good | [Get Key](https://console.groq.com/keys) |
-| 🤖 **OpenAI** | $5 trial | Medium | **Best** | [Get Key](https://platform.openai.com/api-keys) |
-| 🧠 **Anthropic** | Limited trial | Medium | Excellent | [Get Key](https://console.anthropic.com/) |
-| 🏠 **Ollama** | **Unlimited** | Medium | Good | [Install](https://ollama.ai/) |
-| 🔧 **Custom** | Varies | Varies | Varies | Your server |
+| Provider         | Free Tier          | Speed       | Quality   | Get API Key                                       |
+| ---------------- | ------------------ | ----------- | --------- | ------------------------------------------------- |
+| 🆓 **Gemini**    | 15 req/min, 1M/day | Fast        | Good      | [Get Key](https://aistudio.google.com/app/apikey) |
+| ⚡ **Groq**      | Very generous      | **Fastest** | Good      | [Get Key](https://console.groq.com/keys)          |
+| 🤖 **OpenAI**    | $5 trial           | Medium      | **Best**  | [Get Key](https://platform.openai.com/api-keys)   |
+| 🧠 **Anthropic** | Limited trial      | Medium      | Excellent | [Get Key](https://console.anthropic.com/)         |
+| 🏠 **Ollama**    | **Unlimited**      | Medium      | Good      | [Install](https://ollama.ai/)                     |
+| 🔧 **Custom**    | Varies             | Varies      | Varies    | Your server                                       |
 
 ### Quick Setup Examples
 
 **Using Groq (Recommended for free tier):**
+
 ```bash
 export AI_PROVIDER=groq
 export GROQ_API_KEY='your-groq-api-key'
@@ -882,6 +1010,7 @@ devcommit
 ```
 
 **Using Ollama (Local, no API key needed):**
+
 ```bash
 # Install Ollama: https://ollama.ai/
 ollama pull llama3
@@ -890,6 +1019,7 @@ devcommit
 ```
 
 **Using Custom API:**
+
 ```bash
 export AI_PROVIDER=custom
 export CUSTOM_API_URL='http://localhost:8000/v1'
@@ -904,8 +1034,8 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### AI Provider Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
+| Variable      | Description             | Default  | Options                                                     |
+| ------------- | ----------------------- | -------- | ----------------------------------------------------------- |
 | `AI_PROVIDER` | Which AI service to use | `gemini` | `gemini`, `openai`, `groq`, `anthropic`, `ollama`, `custom` |
 
 ### Provider-Specific Settings
@@ -949,21 +1079,23 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### General Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
-| `LOCALE` | Language for commit messages | `en-US` | Any locale code (e.g., `en`, `es`, `fr`) |
-| `MAX_NO` | Number of commit message suggestions | `1` | Any positive integer |
-| `COMMIT_TYPE` | Style of commit messages | `general` | `general`, `conventional`, etc. |
-| `COMMIT_MODE` | Default commit strategy | `auto` | `auto`, `directory`, `global` |
-| `EXCLUDE_FILES` | Files to exclude from diff | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns |
-| `MAX_TOKENS` | Maximum tokens for AI response | `8192` | Any positive integer |
+| Variable        | Description                          | Default                                                | Options                                  |
+| --------------- | ------------------------------------ | ------------------------------------------------------ | ---------------------------------------- |
+| `LOCALE`        | Language for commit messages         | `en-US`                                                | Any locale code (e.g., `en`, `es`, `fr`) |
+| `MAX_NO`        | Number of commit message suggestions | `1`                                                    | Any positive integer                     |
+| `COMMIT_TYPE`   | Style of commit messages             | `general`                                              | `general`, `conventional`, etc.          |
+| `COMMIT_MODE`   | Default commit strategy              | `auto`                                                 | `auto`, `directory`, `global`            |
+| `EXCLUDE_FILES` | Files to exclude from diff           | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns            |
+| `MAX_TOKENS`    | Maximum tokens for AI response       | `8192`                                                 | Any positive integer                     |
 
 ### Configuration Priority
+
 1. **`.dcommit` file** (highest priority)
 2. **Environment variables**
 3. **Built-in defaults** (lowest priority)
 
 ### Using Environment Variables
+
 ```bash
 # Basic setup with Gemini (default)
 export GEMINI_API_KEY='your-api-key-here'
@@ -978,6 +1110,7 @@ export GROQ_API_KEY='your-groq-key'
 ```
 
 ### Using .dcommit File
+
 See `.dcommit.example` for a complete configuration template with all providers.
 
 **Note:** The `.dcommit` file is **optional**. DevCommit will work with just environment variables!

{devcommit-0.1.4.6 → devcommit-0.1.4.8}/README.md

@@ -8,6 +8,9 @@ A command-line AI tool for autocommits.
 - 🚀 Automatic commit generation using AI
 - 📁 Directory-based commits - create separate commits for each root directory
 - 🎯 Interactive mode to choose between global or directory-based commits
+- 📄 **Commit specific files or folders** - Stage and commit only selected files/directories
+- 🔄 **Regenerate commit messages** - Don't like the suggestions? Regenerate with one click
+- 🚀 **Push to remote** - Automatically push commits after committing
 - ⚙️ Flexible configuration - use environment variables or .dcommit file
 - 🏠 Self-hosted model support - use your own AI infrastructure
 - 🆓 Multiple free tier options available
@@ -16,24 +19,27 @@ A command-line AI tool for autocommits.
 
 ## Installation
 
-1. **Install DevCommit**  
-   
+1. **Install DevCommit**
+
    **Option 1: Using pip (local installation)**
+
    ```bash
    pip install devcommit
    ```
-   
+
    **Option 2: Using pipx (global installation, recommended)**
+
    ```bash
    # Install pipx if you don't have it
    python3 -m pip install --user pipx
    python3 -m pipx ensurepath
-   
+
    # Install DevCommit globally
    pipx install devcommit
    ```
+
    > **💡 Why pipx?** pipx installs CLI tools in isolated environments, preventing dependency conflicts while making them globally available.
-   
+
    **All AI providers are included by default!** ✅ Gemini, OpenAI, Groq, Anthropic, Ollama, and Custom API support.
 
 2. **Set Up Configuration (Required: API Key)**  
@@ -42,19 +48,21 @@ A command-line AI tool for autocommits.
    **Priority Order:** `.dcommit` file → Environment Variables → Defaults
 
    ### Option 1: Environment Variables (Quickest)
+
    ```bash
    # Using Gemini (default)
    export GEMINI_API_KEY='your-api-key-here'
-   
+
    # Or using Groq (recommended for free tier)
    export AI_PROVIDER='groq'
    export GROQ_API_KEY='your-groq-key'
-   
+
    # Add to ~/.bashrc or ~/.zshrc for persistence
    echo "export GEMINI_API_KEY='your-key'" >> ~/.bashrc
    ```
 
    ### Option 2: .dcommit File (Home Directory)
+
    ```bash
    cat > ~/.dcommit << 'EOF'
    GEMINI_API_KEY = your-api-key-here
@@ -67,6 +75,7 @@ A command-line AI tool for autocommits.
    ```
 
    ### Option 3: .dcommit File (Virtual Environment)
+
    ```bash
    mkdir -p $VIRTUAL_ENV/config
    cat > $VIRTUAL_ENV/config/.dcommit << 'EOF'
@@ -92,6 +101,7 @@ devcommit
 ### Basic Usage
 
 - **Stage all changes and commit:**
+
   ```bash
   devcommit --stageAll
   ```
@@ -118,6 +128,7 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
 #### Command-Line Usage
 
 - **Interactive mode (auto):** When you have changes in multiple directories, DevCommit will automatically ask if you want to:
+
   - Create one commit for all changes (global commit)
   - Create separate commits per directory
 
@@ -129,10 +140,103 @@ You can set your preferred commit mode in the `.dcommit` configuration file usin
   ```
 
 When using directory-based commits, you can:
+
 1. Select which directories to commit (use Space to select, Enter to confirm)
 2. For each selected directory, review and choose a commit message
 3. Each directory gets its own commit with AI-generated messages based on its changes
 
+### Commit Specific Files or Folders
+
+DevCommit allows you to commit specific files or folders. This is useful when you want to commit only certain changes without affecting other staged files.
+
+**Usage:**
+
+```bash
+# Commit specific files (must be staged first)
+git add file1.py file2.py
+devcommit --files file1.py file2.py
+
+# Stage and commit specific files in one command
+devcommit --stageAll --files file1.py file2.py
+
+# Commit specific folders (must be staged first)
+git add src/ tests/
+devcommit --files src/ tests/
+
+# Stage and commit multiple directories
+devcommit -s -f src/core src/modules/account/ src/modules/auth/
+
+# Short form
+devcommit -s -f file1.py file2.py
+```
+
+When using `--files` or `-f`:
+
+- Without `--stageAll`: Only commits files that are already staged (filters staged files to match specified paths)
+- With `--stageAll`: Stages the specified files/folders and then commits them
+- AI generates commit messages based on changes in those files
+- Works with both individual files and entire directories
+- Files with no changes are automatically filtered out
+
+#### Commit Mode Behavior with `--files`
+
+The `--files` flag respects your `COMMIT_MODE` setting:
+
+- **`COMMIT_MODE=directory`** with `--files`:
+  - **Individual files**: Each file gets its own separate commit
+    - Example: `devcommit -f src/test1.py src/test2.py` creates 2 separate commits
+  - **Directories**: Each directory gets one commit containing all its files
+    - Example: `devcommit -f src/core src/modules/account/` creates 2 commits (one per directory)
+
+- **`COMMIT_MODE=global`** with `--files`:
+  - All specified files/directories are committed together in a single commit
+  - Example: `devcommit -f src/test1.py src/test2.py` creates 1 commit for both files
+
+- **`COMMIT_MODE=auto`** with `--files`:
+  - Always prompts you to choose between one commit for all files or separate commits
+  - If you select directory mode: individual files get separate commits, directories get one commit each
+  - If you select global mode: everything is committed together
+
+### Push to Remote
+
+DevCommit can automatically push your commits to the remote repository after committing.
+
+**Usage:**
+
+```bash
+# Commit all staged changes and push
+devcommit --push
+
+# Commit specific files and push
+devcommit --files file1.py file2.py --push
+
+# Stage, commit, and push in one command
+devcommit --stageAll --push
+
+# Short form
+devcommit -p
+devcommit -f file1.py -p
+```
+
+**Note:** The push operation will only execute if commits were successfully made. If you cancel the commit, the push will be skipped.
+
+### Regenerate Commit Messages
+
+Don't like the AI-generated commit messages? You can regenerate them on the fly!
+
+When viewing commit message options, you'll see:
+- Numbered commit message suggestions
+- ✏️ Enter custom message
+- 🔄 **Regenerate commit messages** (new!)
+- ❌ Cancel
+
+Selecting "Regenerate commit messages" will:
+- Call the AI again to generate new suggestions
+- Show the new messages in the same prompt
+- Allow you to regenerate again or select a message
+
+This works for all commit modes (global, directory, and per-file commits).
+
 ### Additional Options
 
 - `--excludeFiles` or `-e`: Exclude specific files from the diff
@@ -140,6 +244,8 @@ When using directory-based commits, you can:
 - `--commitType` or `-t`: Specify the type of commit (e.g., conventional)
 - `--stageAll` or `-s`: Stage all changes before committing
 - `--directory` or `-d`: Force directory-based commits
+- `--files` or `-f`: Stage and commit specific files or folders (can specify multiple)
+- `--push` or `-p`: Push commits to remote after committing
 
 ### Examples
 
@@ -152,24 +258,46 @@ devcommit --commitType conventional
 
 # Exclude lock files
 devcommit --excludeFiles package-lock.json yarn.lock
+
+# Stage and commit specific files
+devcommit --files file1.py file2.py
+
+# Stage and commit specific folders
+devcommit --files src/ tests/
+
+# Stage and commit multiple files and folders at once
+devcommit --files src/ file1.py tests/ config.json
+
+# Commit and push
+devcommit --push
+
+# Commit specific files and push
+devcommit --files file1.py file2.py --push
+
+# Stage and commit multiple directories with directory mode
+devcommit -s -f src/core src/modules/account/ --directory
+
+# Stage and commit, then push
+devcommit -s -f src/core src/modules/account/ -p
 ```
 
 ## AI Provider Support
 
 DevCommit now supports **multiple AI providers**! Choose from:
 
-| Provider | Free Tier | Speed | Quality | Get API Key |
-|----------|-----------|-------|---------|-------------|
-| 🆓 **Gemini** | 15 req/min, 1M/day | Fast | Good | [Get Key](https://aistudio.google.com/app/apikey) |
-| ⚡ **Groq** | Very generous | **Fastest** | Good | [Get Key](https://console.groq.com/keys) |
-| 🤖 **OpenAI** | $5 trial | Medium | **Best** | [Get Key](https://platform.openai.com/api-keys) |
-| 🧠 **Anthropic** | Limited trial | Medium | Excellent | [Get Key](https://console.anthropic.com/) |
-| 🏠 **Ollama** | **Unlimited** | Medium | Good | [Install](https://ollama.ai/) |
-| 🔧 **Custom** | Varies | Varies | Varies | Your server |
+| Provider         | Free Tier          | Speed       | Quality   | Get API Key                                       |
+| ---------------- | ------------------ | ----------- | --------- | ------------------------------------------------- |
+| 🆓 **Gemini**    | 15 req/min, 1M/day | Fast        | Good      | [Get Key](https://aistudio.google.com/app/apikey) |
+| ⚡ **Groq**      | Very generous      | **Fastest** | Good      | [Get Key](https://console.groq.com/keys)          |
+| 🤖 **OpenAI**    | $5 trial           | Medium      | **Best**  | [Get Key](https://platform.openai.com/api-keys)   |
+| 🧠 **Anthropic** | Limited trial      | Medium      | Excellent | [Get Key](https://console.anthropic.com/)         |
+| 🏠 **Ollama**    | **Unlimited**      | Medium      | Good      | [Install](https://ollama.ai/)                     |
+| 🔧 **Custom**    | Varies             | Varies      | Varies    | Your server                                       |
 
 ### Quick Setup Examples
 
 **Using Groq (Recommended for free tier):**
+
 ```bash
 export AI_PROVIDER=groq
 export GROQ_API_KEY='your-groq-api-key'
@@ -177,6 +305,7 @@ devcommit
 ```
 
 **Using Ollama (Local, no API key needed):**
+
 ```bash
 # Install Ollama: https://ollama.ai/
 ollama pull llama3
@@ -185,6 +314,7 @@ devcommit
 ```
 
 **Using Custom API:**
+
 ```bash
 export AI_PROVIDER=custom
 export CUSTOM_API_URL='http://localhost:8000/v1'
@@ -199,8 +329,8 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### AI Provider Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
+| Variable      | Description             | Default  | Options                                                     |
+| ------------- | ----------------------- | -------- | ----------------------------------------------------------- |
 | `AI_PROVIDER` | Which AI service to use | `gemini` | `gemini`, `openai`, `groq`, `anthropic`, `ollama`, `custom` |
 
 ### Provider-Specific Settings
@@ -244,21 +374,23 @@ All configuration can be set via **environment variables** or **`.dcommit` file*
 
 ### General Settings
 
-| Variable | Description | Default | Options |
-|----------|-------------|---------|---------|
-| `LOCALE` | Language for commit messages | `en-US` | Any locale code (e.g., `en`, `es`, `fr`) |
-| `MAX_NO` | Number of commit message suggestions | `1` | Any positive integer |
-| `COMMIT_TYPE` | Style of commit messages | `general` | `general`, `conventional`, etc. |
-| `COMMIT_MODE` | Default commit strategy | `auto` | `auto`, `directory`, `global` |
-| `EXCLUDE_FILES` | Files to exclude from diff | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns |
-| `MAX_TOKENS` | Maximum tokens for AI response | `8192` | Any positive integer |
+| Variable        | Description                          | Default                                                | Options                                  |
+| --------------- | ------------------------------------ | ------------------------------------------------------ | ---------------------------------------- |
+| `LOCALE`        | Language for commit messages         | `en-US`                                                | Any locale code (e.g., `en`, `es`, `fr`) |
+| `MAX_NO`        | Number of commit message suggestions | `1`                                                    | Any positive integer                     |
+| `COMMIT_TYPE`   | Style of commit messages             | `general`                                              | `general`, `conventional`, etc.          |
+| `COMMIT_MODE`   | Default commit strategy              | `auto`                                                 | `auto`, `directory`, `global`            |
+| `EXCLUDE_FILES` | Files to exclude from diff           | `package-lock.json, pnpm-lock.yaml, yarn.lock, *.lock` | Comma-separated file patterns            |
+| `MAX_TOKENS`    | Maximum tokens for AI response       | `8192`                                                 | Any positive integer                     |
 
 ### Configuration Priority
+
 1. **`.dcommit` file** (highest priority)
 2. **Environment variables**
 3. **Built-in defaults** (lowest priority)
 
 ### Using Environment Variables
+
 ```bash
 # Basic setup with Gemini (default)
 export GEMINI_API_KEY='your-api-key-here'
@@ -273,6 +405,7 @@ export GROQ_API_KEY='your-groq-key'
 ```
 
 ### Using .dcommit File
+
 See `.dcommit.example` for a complete configuration template with all providers.
 
 **Note:** The `.dcommit` file is **optional**. DevCommit will work with just environment variables!