Configuration - AgentGG

Where the config lives

agentgg init writes the saved config to ~/.agentgg/config.json. It holds your provider, model, and mode defaults, and the default OpenRouter routing. Set the AGENTGG_HOME environment variable to keep the config in a different directory.

Read the config

Run agentgg config to print the saved config. It masks secrets. Pass --json for machine-readable output. See Commands for the full flag list, including how to change the default provider or model. To save the default OpenRouter routing, see OpenRouter routing.

Add a second provider

Run agentgg init again to add another provider. It merges the new provider into the config and does not overwrite the first one.

The agent catalog

agentgg keeps agents in two places:

Location	Purpose
`~/.agentgg/agentgg-agents/`	The official agent catalog. `agentgg agents update` refreshes it.
`~/.agentgg/agents/custom/`	Agents you install yourself with `agentgg agents add`.

Scan state is separate

Scan state lives in the output directory you pass to -o, not in ~/.agentgg/config.json. You can delete the config file and keep every scan result.