Configuration

Global settings

Global settings apply to all repositories on your machine.

Location

• Linux: ~/.config/corg/settings.json
• macOS: ~/.config/corg/settings.json

Options

Example

{
  "theme": "dark",
  "diffViewMode": "split",
  "baseBranch": "main"
}

Repository settings

Override global settings for a specific repository.

Location

.corg/settings.json in the repository root.

Supports the same options as global settings. Useful for setting a per-repo base branch:

{
  "baseBranch": "develop"
}

Priority order

Settings are resolved in this order (highest to lowest):

1. CLI flags — Always win
2. Repository config — .corg/settings.json
3. Global config — ~/.config/corg/settings.json
4. Defaults

Base branch detection

When running corg review with no arguments on a feature branch, CorgReview needs to know which branch is your "main" branch to diff against.

Auto-detection checks for branches in this order:

1. main
2. master
3. develop

Override this with the baseBranch setting in your global or repo config.

Review file storage

Reviews are saved as markdown files in your repository:

your-repo/
└── .corg/
    └── reviews/
        ├── 2026-03-08-abc123-def456.md    # Commit range reviews
        └── 2026-03-feat-my-feature.md      # Branch reviews

The default output directory is .corg/reviews/, overridable with the --output-dir flag.

You can commit these files to your repo for an audit trail, or add .corg/ to your .gitignore.

UI preferences

These preferences are set directly in the review UI and persist via localStorage in your browser:

• Diff view mode (unified / split)
• File tree panel width
• Review summary panel height
• Theme (light / dark)

To reset all panel sizes to defaults, go to Settings > Layout > "Reset Panel Sizes" in the review UI.