Windows: GGA config path mismatch with gentle-ai generated global config

[NicoVanderschueren]

Pre-flight Checklist

• I have searched existing issues and this is not a duplicate
• I understand that PRs will be rejected if the linked issue does not have status:approved

📝 Bug Description

On Windows, gentle-ai generates the GGA global config under:

%USERPROFILE%\.config\gga\config

but GGA appears to read from:

%APPDATA%\gga\config

As a result, gga config reports no global config and no provider, even though gentle-ai generated one.

This also conflicts with GGA's own configuration documentation, which describes the global config path as:

~/.config/gga/config

🔄 Steps to Reproduce

1. Install gentle-ai with a preset that includes GGA, such as full-gentleman or ecosystem-only.
2. Verify that gentle-ai generated the GGA config:

Test-Path "$env:USERPROFILE\.config\gga\config"
Test-Path "$env:USERPROFILE\.config\gga\AGENTS.md"
Get-Content "$env:USERPROFILE\.config\gga\config"

3. Run:

gga config

4. Check whether %APPDATA%\gga\config exists:

Test-Path "$env:APPDATA\gga\config"

✅ Expected Behavior

The config path used by gentle-ai and the config path read by gga should match on Windows.

After installing a preset that includes GGA, gga config should show the generated global config and provider.

❌ Actual Behavior

gentle-ai generated these files successfully:

%USERPROFILE%\.config\gga\config
%USERPROFILE%\.config\gga\AGENTS.md

Both paths return True with Test-Path.

The generated config contains:

PROVIDER="opencode"
RULES_FILE="AGENTS.md"

But gga config reports:

Config Files:
  Global:  Not found
  Project: Not found

Values:
  PROVIDER:          Not configured
  FILE_PATTERNS:     *
  EXCLUDE_PATTERNS:  None
  RULES_FILE:        AGENTS.md
  STRICT_MODE:       true
  TIMEOUT:           300s
  PR_BASE_BRANCH:    auto-detect

Rules File: Not found (AGENTS.md)

APPDATA points to:

%USERPROFILE%\AppData\Roaming

and this path does not exist:

%APPDATA%\gga\config

---

🖥️ Environment

Gentle AI Version

1.23.0

GGA version: 2.8.1

Install method: Scoop

Shell: PowerShell

Operating System

Windows

AI Agent / Client

OpenCode

📋 Affected Area

Installation Pipeline

💡 Logs / Error Output

Config Files:
  Global:  Not found
  Project: Not found

Values:
  PROVIDER:          Not configured
  FILE_PATTERNS:     *
  EXCLUDE_PATTERNS:  None
  RULES_FILE:        AGENTS.md
  STRICT_MODE:       true
  TIMEOUT:           300s
  PR_BASE_BRANCH:    auto-detect

Rules File: Not found (AGENTS.md)

Additional Context

Technical Notes

gentle-ai writes GGA config using:

ConfigPath(homeDir) => ~/.config/gga/config

But the installed GGA script prioritizes $APPDATA/gga/config on Windows when APPDATA is set.

This creates a path mismatch:

Written by gentle-ai:
%USERPROFILE%\.config\gga\config

Read by GGA:
%APPDATA%\gga\config

Impact

This is more than cosmetic: GGA is installed, but it does not pick up the provider generated by gentle-ai, so users may think GGA is configured when it is not.

Project-level hooks still need to be enabled manually with:

gga init
gga install

That part is expected. The issue is only about the global config generated by gentle-ai not being read by GGA on Windows.

Related

Related Windows/GGA reports exist, but they appear to cover different symptoms:

• No instala Engram ni GGA en Windows #177 reports GGA as not detected on Windows even though it can be accessed from PowerShell.
• [Windows] install/sync/uninstall fail with Access is denied while writing managed files #293 mentions writes under %USERPROFILE%\.config\gga\AGENTS.md, but its root symptom is Access is denied while writing managed files.

This issue is specifically about the path mismatch where gentle-ai writes GGA config under %USERPROFILE%\.config\gga\, while GGA reads from %APPDATA%\gga\ on Windows.