Configuration

Global gtl settings are stored in $XDG_CONFIG_HOME/gtl/config.json when XDG_CONFIG_HOME is set. Otherwise, they are stored in ~/.config/gtl/config.json.

Use gtl config list to print the full global config file.

gtl config list
gtl config get default-clone-path
gtl config set default-clone-path /Users/name/projects

Stored Values

config.json stores durable settings such as:

• clone_destination, set with gtl config set default-clone-path <path>
• repo_paths, saved by gtl find <repo> --set-path
• identity_profiles, used by gtl identity

The older clone-destination key is still accepted as an alias. Older identity.json files are read as a migration fallback when config.json does not contain identity profiles; new identity saves write to config.json.

Repository-Local Files

Repository-local generated files are stored under .gtl/ inside the current repository. Examples include:

• .gtl/repo-list.json
• .gtl/pull-requests/
• .gtl/issues/
• .gtl/env/AGENT_PRECHECK.md

Commands that write local runtime files add .gtl/ and identity files such as .envrc to .git/info/exclude, keeping them out of commits while allowing local tooling to read them.