@@ -152,7 +152,18 @@ git-sc -g abc1234 -b # With detailed body
152152
153153## Configuration
154154
155- Config file: ` ~/.git-sc `
155+ ### Hierarchical Configuration
156+
157+ git-sc supports hierarchical configuration with project-level overrides:
158+
159+ | File | Scope | Description |
160+ | ------| -------| -------------|
161+ | ` ~/.git-sc ` | Global | User-wide default settings |
162+ | ` .git-sc ` | Project | Repository-specific overrides (in repo root) |
163+
164+ Project settings override global settings. Fields not specified in project config inherit from global config.
165+
166+ ### Example Configuration
156167
157168``` toml
158169# AI provider priority
@@ -161,6 +172,13 @@ providers = ["gemini", "codex", "claude"]
161172# Commit message language
162173language = " Japanese"
163174
175+ # Commit prefix format (optional)
176+ # Values: conventional, bracket, colon, emoji, plain, none
177+ prefix_type = " conventional"
178+
179+ # Auto-push after commit (optional)
180+ auto_push = true
181+
164182# Model configuration
165183[models ]
166184gemini = " flash"
@@ -177,11 +195,24 @@ provider_cooldown_minutes = 60
177195| --------| -------------| ---------|
178196| ` providers ` | AI provider priority | ` ["gemini", "codex", "claude"] ` |
179197| ` language ` | Commit message language | ` "Japanese" ` |
198+ | ` prefix_type ` | Commit prefix format | Auto-detect |
199+ | ` auto_push ` | Auto-push after commit | ` false ` |
180200| ` models.* ` | Model for each provider | See config |
181201| ` provider_cooldown_minutes ` | Failed provider cooldown | ` 60 ` |
182202| ` prefix_rules ` | URL-based prefix format | ` [] ` |
183203| ` prefix_scripts ` | External prefix scripts | ` [] ` |
184204
205+ ### prefix_type Values
206+
207+ | Value | Example | Description |
208+ | -------| ---------| -------------|
209+ | ` conventional ` | ` feat: add feature ` | Conventional Commits format |
210+ | ` bracket ` | ` [feat] add feature ` | Bracket-style prefix |
211+ | ` colon ` | ` feat: add feature ` | Simple colon prefix |
212+ | ` emoji ` | ` :sparkles: add feature ` | Emoji prefix |
213+ | ` plain ` | ` Add feature ` | No prefix |
214+ | ` none ` | ` add feature ` | No prefix, lowercase |
215+
185216### Prefix Rules
186217
187218Specify commit format by remote URL:
@@ -218,15 +249,18 @@ Cargo.lock
218249*.generated.ts
219250```
220251
221- ### .git-sc-auto-push
252+ ### Auto Push
222253
223- Create this file in the repository root to automatically push after commit :
254+ Enable auto-push in your config file :
224255
225- ``` bash
226- touch .git-sc-auto-push
256+ ``` toml
257+ # In ~/.git-sc or .git-sc
258+ auto_push = true
227259```
228260
229- When this file exists, ` git-sc ` will run ` git push ` after a successful commit or squash.
261+ When enabled, ` git-sc ` will run ` git push ` after a successful commit or squash.
262+
263+ > ** Note** : The legacy ` .git-sc-auto-push ` file is still supported for backward compatibility.
230264
231265## VS Code Extension
232266
0 commit comments